Actions
coordination #50507
open[qe-core][functional][saga] document lib/ functions
Status:
New
Priority:
Normal
Assignee:
-
Category:
Enhancement to existing tests
Target version:
SUSE QA - Milestone 31
Start date:
2019-05-08
Due date:
% Done:
75%
Estimated time:
(Total: 0.00 h)
Difficulty:
Description
Motivation¶
As we currently have no documentation for the functions in lib/ we need a mechanism to automatically generate it from POD inside the files.
Further details¶
The team decided to apply the best practices described in https://www.perl.com/pub/2005/07/14/bestpractices.html/
Checklist
- enable gh-pages on os-autoinst-distri-opensuse
- adapt travis to create and deploy documentation to gh-pages
- write documentation for each lib/ function
- fancy up the html output
- document the gh-pages in the wiki, maybe crosslink in open.qa
Actions