On 01/09/13 23:02, Anne Gentle wrote:
On Sat, Aug 31, 2013 at 9:09 AM, Lorin Hochstein
<lo...@nimbisservices.com <mailto:lo...@nimbisservices.com>> wrote:
On Fri, 30 Aug 2013 08:33:40 -0500, Anne Gentle wrote:
I applaud Julien's note and we're happy to work with the teams on
finding
where docs should go. Julien's feeling very behind, and I'm sure other
projects are feeling the same.
We all have to set priorities. Here's where I'd start.
Log doc bugs in openstack-manuals for:
installation
configuration
day-to-day running
end-user tasks
admin tasks
troubleshooting
Log doc bugs in openstack-api-site for:
API reference docs
Would it help if doc bugs were associated with the relevant
OpenStack project, in addition to the openstack-manauls project? For
example, we could mark nova-related doc bugs as "nova" project bugs
in addition to "openstack-manuals" project bugs.
I like this idea and it seems fairly trivial to do automatically --
teams, unless you see a big problem with this approach I'll patch the
DocImpact automation tool on Monday.
... and I'll do a manual update of the current bug list:
https://launchpad.net/openstack-manuals/+milestone/havana
https://launchpad.net/openstack-api-site/+milestone/havana
which anyone is welcome to work on before then :) even just dumps of
rant-y text in the bugs you care about welcome!
Anne
This would make outstanding doc issues more visible to the relevant
devs, and would reinforce the idea that missing/incorrect
documentation in, say, nova should be viewed as a *nova* issue and
not simply a *documentation* issue. In particular, it could generate
more doc-focused effort when it comes time for the pre-release bug
squashing activities, since devs will be encouraged to squash those
bugs in their project.
Take care,
Lorin
--
Lorin Hochstein
Lead Architect - Cloud Services
Nimbis Services, Inc.
www.nimbisservices.com <https://www.nimbisservices.com/>
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
<mailto:OpenStack-dev@lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
--
Anne Gentle
annegen...@justwriteclick.com <mailto:annegen...@justwriteclick.com>
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
_______________________________________________
OpenStack-dev mailing list
OpenStack-dev@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
