I kind of liked "DocumentationToDo" because it made it clear what kind
of attention was needed. When I first saw "UpdateMe", I thought
it might be a tag indicating that the underlying functionality needed
some sort of update.<br>
<br>
In fact, a tag like that would be helpful. I'm sure there are
recipes that haven't kept up with the betas, some that may not have
"lead developers" any more, but that it would be nice to be able to use
if they were updated.<br><br><div><span class="gmail_quote">On 3/10/06, <b class="gmail_sendername">Patrick R. Michaud</b> <<a href="mailto:pmichaud@pobox.com">pmichaud@pobox.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Fri, Mar 10, 2006 at 12:00:42AM -0500, Neil Herber wrote:<br>> At 2006-03-09 12:13 AM -0600, Patrick R. Michaud is rumored to have said:<br>> >It's also a good idea to be familiar with the documentation guidelines
<br>> >at <a href="http://www.pmwiki.org/wiki/PmWiki/DocumentationGuidelines">http://www.pmwiki.org/wiki/PmWiki/DocumentationGuidelines</a> .<br>> ><br>> >If there are any questions, feel free to put them in the pages
<br>> >or ask the list. If something needs my specific attention, just<br>> >put it in the [[!Update me]] category or send an email.<br>><br>> Note that the suggested markup for incomplete docs<br>> on
<a href="http://www.pmwiki.org/wiki/PmWiki/DocumentationGuidelines">http://www.pmwiki.org/wiki/PmWiki/DocumentationGuidelines</a> is<br>> [[!DocumentationToDo]] .<br>><br>> Should this be changed to [[!Update me]] or should we use both?
<br><br>My initial thought is that we should use both -- my original<br>conception of [[!Update me]] was that it's targeted to me personally<br>(as in "This needs Pm's direct attention"). [[!DocumentationToDo]]
<br>would be a note to just anyone.<br><br>OTOH, [[!Update me]] could become a useful convention that many<br>sites could use and that would extend beyond just the PmWiki<br>documentation, so perhaps it's a meme we could try cultivating
<br>and see what happens.<br><br>Perhapse [[!Update me]] is a bit more imperative, while<br>[[!DocumentationToDo]] just becomes a note that more work<br>needs to be done on the documentation but it's not likely to<br>happen immediately.
<br><br>For now, let's change [[!DocumentationToDo]] to [[!Update me]]<br>in the guidelines, and see what happens. I can convert [[!Update me]]<br>to [[!DocumentationToDo]] as appropriate.<br><br>Thanks!<br><br>Pm<br><br>
_______________________________________________<br>pmwiki-users mailing list<br><a href="mailto:pmwiki-users@pmichaud.com">pmwiki-users@pmichaud.com</a><br><a href="http://host.pmichaud.com/mailman/listinfo/pmwiki-users">
http://host.pmichaud.com/mailman/listinfo/pmwiki-users</a><br></blockquote></div><br>