That makes a lot of sense. It's also a way to encourage low hanging fruit documentation for folks interested in a particular project. Otherwise, they are not very visible.
------------------------------------------------- Brian Schott, CTO Nimbis Services, Inc. brian.sch...@nimbisservices.com ph: 443-274-6064 fx: 443-274-6060 On Aug 31, 2013, at 10:09 AM, Lorin Hochstein <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. > > 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 > > _______________________________________________ > OpenStack-dev mailing list > OpenStack-dev@lists.openstack.org > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
smime.p7s
Description: S/MIME cryptographic signature
_______________________________________________ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
