Policy Statement
Developers may fix or augment documentation on master whenever they notice something that is unclear. The restrictions would be that:
- You may only modify comments
- You must run the unit-tests before pushing
- If you are proved to have broken the buildbot build, and we find that you modified something other than comments, you will be harshly reprimanded
Whenever you have any question whatsoever about the correctness of a change you must instead file a ticket as usual, or at least ask a question on "stackoverflow".
Pedigree
The above policy was approved by the DM TCT on 2014-Jan-30.
Further Explanatory Commentary
Everyone is encouraged to look things up on the NCSA master doxygen site at http://lsst-web.ncsa.illinois.edu/~buildbot/doxygen/x_masterDoxyDoc/index.html and whenever they find something unclear invoke this new policy and FIX IT.
There was a concern that the impedance of creating a ticket, then a branch, then waiting for a review, then doing a merge, then another push, then editing the ticket, would be enough for people not to make the changes. Indeed, that at least the more law-abiding among DM were not updating docs because of the ticket rules.