[openstack-dev] [Ceilometer] Documentation and patches

Brian Schott brian.schott at nimbisservices.com
Sat Aug 31 14:32:15 UTC 2013


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.schott at nimbisservices.com
ph: 443-274-6064  fx: 443-274-6060



On Aug 31, 2013, at 10:09 AM, Lorin Hochstein <lorin at 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 at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130831/9f726693/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 3658 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20130831/9f726693/attachment.bin>


More information about the OpenStack-dev mailing list