Gervase Markham wrote: >> Okay, I've filed bug 157668 for this. I proposed two keywords (hope >> you don't mind), one for "docnotes", when someone thinks there's >> something worthy of doc'ing, and "docnotes+", for when we've made the >> appropriate documentation note. > > > This is an unusual use of the "+" notation, which normally denotes some > sort of approval rather than a task completed. I would prefer some other > distinguisher be used. >
The keyword could be removed when the task is completed ... maybe a comment pointing to the doc could be added instead of a "+". > Also, why "docnotes"? It won't necessarily involve writing notes. Why > not "documentation" or "docwanted" (by analogy with qawanted)? > This is related to my theory that we need a conscious separation between full-fledged docs and little notes. docnote or docwanted both seem fine though. --John
