'make lint' should warn about invalid docstrings

Bug #385736 reported by Jonathan Lange
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Launchpad itself
Triaged
Low
Unassigned

Bug Description

We generate API docs @ https://devpad.canonical.com/~mwh/canonicalapi/ but there are a lot of invalid docstrings.

mwh gets an email every night telling him about which are invalid. This isn't going to help anyone get better docs. Instead, make lint should check that there are no invalid docstrings in the changed file.

I personally do not think that "missing" counts as invalid. Maybe it should.

affects: launchpad → launchpad-foundations
Jonathan Lange (jml)
tags: added: build-infrastructure
removed: infrastructure
Changed in launchpad-foundations:
assignee: Michael Hudson (mwhudson) → nobody
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.