Docs Status
- From: Shaun McCance <shaunm gnome org>
- To: gnome-doc-list gnome org
- Subject: Docs Status
- Date: Fri, 05 Dec 2014 16:07:13 -0500
Hi all,
I'm working on generalizing the page-level status tracking we've used
for a few years now to get buy-in from some other projects on a common
documentation lifecycle. Recall ours looks like this:
https://wiki.gnome.org/DocumentationProject/StatusTracking
And it got non-normatively memorialized in the Mallard spec:
http://projectmallard.org/1.0/mal_info_revision
All of you have been using this for a while now, so I'd like to solicit
feedback on it to see how it could be improved, as well as what works
well right now. Bullet list of questions:
* Are there any statuses on the list you never use?
* Do you find yourself wanting a status that's not on the list? I know
we've used a few ad-hoc statuses at hackfests, but I can't remember what
we used them for.
* Are any statuses confusingly named? I remember "review" wasn't very
popular because it's not an adjective. It's really "ready for review",
but I wanted a succinct word.
* Are any statuses otherwise poorly named? I remember Jim didn't like
"outdated" because it was demotivating to have all your stuff called
outdated once you release. That might be a place for an additional
status. One for "need to check if this is up to date" and one for "we
checked and we know it ain't".
* What's your favorite kind of cheese?
Thanks for the feedback.
--
Shaun
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]