Documentation Status Tracking
- From: Shaun McCance <shaunm gnome org>
- To: gnome-doc-list gnome org
- Subject: Documentation Status Tracking
- Date: Fri, 26 Sep 2008 12:19:45 -0500
As many of you know, I've been working on a system called Pulse
to help us track our documentation. It's now at a stage where
it can offer genuinely useful information that can significantly
help use prioritize our efforts.
http://www.gnome.org/~shaunm/pulse/web/
We can easily see what documents exist, but what we really need
to know is what the status of each document is. In order to do
this, I've come up with a system of recording status information
directly in the DocBook.
I've written a proposal for how I think we should handle this:
http://live.gnome.org/DocumentationProject/StatusTracking
I would appreciate it if you could look this over and offer
suggestions. A system that doesn't work for our community
won't solve our problems, so it's important that I know how
well you all think this will work for your workflow.
Note that I believe the proposed system can also help our
intrepid translators. I don't believe we are ready yet to
impose hard freezes on documentation, but this system does
impose freezes on any documents marked as "final". While
not a complete solution, this can at least help translators
prioritize which documents they work on.
--
Shaun
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]