action #51413
opencoordination #50507: [qe-core][functional][saga] document lib/ functions
[qe-core][functional] Automatic checks for missing documentation in /lib
0%
Description
AC¶
- AC: It is ensured, that everyone adding new functionality also documents it
Tasks¶
- Create a mechanism that runs pod-checker and shows a list of undocumented functions under /lib
- PR are not able to be merged if the check doesn't pass (or is below under a certain threshold)
Suggestions¶
- Take into account situations where routines/function are so small that don't need documentation,
##nodoc
could be an option to indicate the parser, that the following method doesn't need to be checked. - Document methods in /lib where it would be useful.
- Figure and propose a podchecker documentation format (and use that script to for the automated checks on travis) (see poo#50510)
Updated by jorauch over 4 years ago
- Status changed from Workable to In Progress
- Assignee set to jorauch
Updated by mgriessmeier over 4 years ago
- Target version changed from Milestone 25 to Milestone 26
Updated by jorauch over 4 years ago
In my understanding podchecker is not feasible for this task, as it only checks if the syntax of the given pod file is correct or if the file contains POD at all.
Updated by jorauch over 4 years ago
we could reuse one of my old hackweek projects, as a script to check if every function contains documentation
Updated by jorauch over 4 years ago
- Status changed from In Progress to Workable
we still need a decision here
Updated by jorauch over 4 years ago
- Status changed from Workable to Feedback
Putting in the feedback queue for discussion reasons
Updated by SLindoMansilla over 4 years ago
For checking missing documentation of particular functions inside a file taking into account that there are functions that don't need to be documented. (##nodoc)
Check documentation coverage.
Updated by mgriessmeier over 4 years ago
- Target version changed from Milestone 26 to Milestone 27
@ jojo, let's discuss status here once you're back from vacation
Updated by mgriessmeier over 4 years ago
- Target version changed from Milestone 27 to Milestone 28
Updated by jorauch over 4 years ago
- Assignee changed from jorauch to SLindoMansilla
We should discuss this sometimes
Updated by mgriessmeier about 4 years ago
- Target version changed from Milestone 28 to Milestone 30
needs to be discussed offline
Updated by SLindoMansilla about 4 years ago
- Status changed from Feedback to New
- Assignee deleted (
SLindoMansilla)
Updated by szarate over 3 years ago
- Description updated (diff)
- Category changed from Enhancement to existing tests to Spike/Research
- Start date deleted (
2019-05-13)
The task was groomed online a bit, but at the moment there seems to be no clear picture for this task still, so we can pick it up later on.
Updated by tjyrinki_suse over 3 years ago
- Subject changed from [functional][u] Automatic checks for missing documentation in /lib to [qe-core][functional] Automatic checks for missing documentation in /lib
Updated by okurz over 2 years ago
I came to this ticket due to periodically reviewing tickets as described on https://progress.opensuse.org/projects/openqatests/wiki#How-we-work-on-tickets
This ticket was set to "Normal" priority but was not updated within the SLO period for "Normal" tickets (365 days) as described on https://progress.opensuse.org/projects/openqatests/wiki/Wiki#SLOs-service-level-objectives
First reminder: Please consider picking up this ticket within the next 365 days or just set the ticket to the next lower priority of "Low" (no SLO related time period).
Updated by slo-gin over 1 year ago
This ticket was set to Normal priority but was not updated within the SLO period. Please consider picking up this ticket or just set the ticket to the next lower priority.
Updated by slo-gin 9 days ago
This ticket was set to Normal priority but was not updated within the SLO period. Please consider picking up this ticket or just set the ticket to the next lower priority.