<HTML><BODY style="word-wrap: break-word; -khtml-nbsp-mode: space; -khtml-line-break: after-white-space; ">Kieran,<DIV><BR class="khtml-block-placeholder"></DIV><DIV>Cool, I hadn't thought of front paging it. Maybe since you have to be a docs maintainer to help I can make it a general call for people to join docs and mention the specific mission of comment rolling as a task people can start right in on. Basically give folks some specific direction on how to help out right now with the handbooks. I'll work on this tomorrow and run it by the appropriate "people of powah". Thanks for the suggestion.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>- Addi</DIV><DIV><BR><DIV><DIV>On Apr 14, 2007, at 4:44 PM, Kieran Lal wrote:</DIV><BR class="Apple-interchange-newline"><BLOCKQUOTE type="cite">Hi Addi, thanks for doing this. When I had <A onclick="return top.js.OpenExtLink(window,event,this)" href="http://drupal.org/handbook/comments" target="_blank">http://drupal.org/handbook/</A><A href="http://drupal.org/handbook/comments"> comments</A> made over a year ago, I hoped someone like yourself would step forward to do this.<BR><BR>Over the last couple of years Dries has encouraged the documentation team to publish more posts to the front page of <A href="http://Drupal.org"> Drupal.org</A>. I think if you could summarize your effort into a call to action that this is a worthy story of the <A href="http://Drupal.org">Drupal.org</A> front page.<BR><BR>Be sure to run it by Steven Peck, the docs maintainer, first. <BR><BR>Cheers,<BR>Kieran<BR><BR><DIV><SPAN class="gmail_quote">On 4/7/07, <B class="gmail_sendername">Addi Berry</B> <<A href="mailto:addi@rocktreesky.com">addi@rocktreesky.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;"> Hello fellow doc maintainers,<BR><BR>Since I became a site maintainer at OSCMS a few weeks back I have<BR>been on a mission to delete comments from the handbooks. I have been<BR>chipping away at the list and as of writing this email there are only <BR>19 pages that have more than 10 comments each to them. I have been<BR>deleting useless comments (thanks and support requests) and rolling<BR>in useful ones. There are literally hundreds (maybe 500+?) pages with<BR>comments and so I am asking for a little help here. <BR><BR>Doc maintainers cannot delete comments but you can roll comments into<BR>the handbook and identify comments that can be deleted. What do I<BR>mean by roll them in? Glad you asked. :) Here is a little step by step: <BR><BR>1. Go to the list of pages with comments: <A href="http://drupal.org/handbook/">http://drupal.org/handbook/</A><BR>comments (you can also find this in the Contributor Links block on d.o)<BR>2. Pick a page, start at the bottom for those with only 2 comments or <BR>start at the top for the biggies.<BR>3. Read the page, read the comments and determine if there is useful<BR>info/corrections in the comments.<BR>4. Roll it:<BR> a. if there are corrections or additional info that would be good to <BR>have in the page - please edit the page.<BR> b. if there is extra goodness that is not good for that page, copy<BR>the comment into a new page (normally a good location is as a child<BR>page of where you are). I also normally make sure to add a note to <BR>the log giving the original comment poster credit (e.g. "from comment<BR>by username")<BR>5. Kill it: Once you roll in the useful bits (or if there are no<BR>useful bits) create an issue for a site admin to delete the <BR>comments. Just name the issue Delete Comments, make it a task and<BR>provide links to the page(s). Feel free to create one issue that<BR>lists a whole bunch of pages that need comments deleted (when I did<BR>this, I just opened a notepad on my puter and copy/pasted the URL of <BR>each page I worked on, then copied the whole list into an issue). The<BR>more the merrier.<BR><BR>Note: if you aren't sure about all of the comments or weren't able to<BR>roll them in but think they are still useful you can also post an <BR>issue that says, delete all the comments except x, y and z, where x,<BR>y and z are a list of the URL directly to the comment or the title of<BR>the comment.<BR><BR>I will be checking the issue queue for comment deletions pretty much <BR>all the time and if you have questions or want an immediate purge,<BR>you can always try to catch me on IRC. I'm normally hanging out in<BR>#drupal or #drupal-dojo whenever I'm online (IRC nick is add1sun).<BR> <BR>Thanks for your help and remember, Doc maintainers Rule! (and make<BR>the world a better place)<BR>- Addi<BR>--<BR>Pending work: <A href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/ </A><BR>List archives: <A href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</A><BR></BLOCKQUOTE></DIV><BR><BR clear="all"><BR>-- <BR>To strive, to seek, to find, and not to yield. <BR><DIV style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; ">--</DIV><DIV style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; ">Pending work: <A href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/</A></DIV><DIV style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; ">List archives: <A href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</A></DIV> </BLOCKQUOTE></DIV><BR></DIV></BODY></HTML>