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>