[documentation] [Documentation task] New page "Documentation issue reports"

karldied drupal-docs at drupal.org
Sun Jan 28 03:02:10 UTC 2007


Issue status update for 
http://drupal.org/node/111742
Post a follow up: 
http://drupal.org/project/comments/add/111742

 Project:      Documentation
 Version:      <none>
 Component:    Misc
-Category:     feature requests
+Category:     tasks
 Priority:     normal
 Assigned to:  karldied
 Reported by:  karldied
 Updated by:   karldied
-Status:       patch (code needs work)
+Status:       patch (code needs review)

New page at http://drupal.org/node/24565, available for inspection,
review, and feedback. webchick's comments elsewhere and more research
solved most of the questions. Page updated from earlier draft. The idea
is to describe the process so it functions efficiently and smoothly for
all of us on the doc team. If there are better "best practices," I have
no problem with changing or updating the guidelines.




karldied



Previous comments:
------------------------------------------------------------------------

Mon, 22 Jan 2007 17:59:57 +0000 : karldied

Attachment: http://drupal.org/files/issues/999-doc issue reports.html (4.69 KB)

The attached is a draft proposed "Documentation issue reports" to
provide guidelines and information to those new to issue reports.
Feedback sought. The following deserve particular attention since
they're my best guess: 


* The use of "duplicate" status, whether it then goes to "fixed," and
by whom.
* When to use attachments.
* The use of "+1/-1" and "@username" in comments are my best guess.
* Discussion of using issue reports in most cases rather than the
e-mail list.


One of my perceptions is that topics sent only to the e-mail list slip
through the cracks too easily. Consequently this draft proposes that
people submit an issue to request to join the doc team, which I also put
in "Joining the doc team" last week. 


-karldied






More information about the documentation mailing list