[openstack-dev] [OpenStack-docs] Fwd: [Neutron][LBaaS][Octavia][Docs] Need experienced contributor documentation best-practices and how-tos

Matt Kassawara mkassawara at gmail.com
Mon Mar 7 15:55:30 UTC 2016


Snipping a lot, because I'm particularly interested in one comment...


> I agree that many developers (especially developers of those groups new to
> the big tent) seem to think that they need to be on the top level
> docs.openstack.org, without necessarily understanding that
> docs.openstack.org/developer is usually the more appropriate place, at
> least to begin with. This should probably be made more explicit both in the
> Infra Manual, plus anywhere that Foundation is discussing big tent
> inclusion.


We tell operators and users to look at the documentation on
docs.openstack.org because the documentation in /developer is aimed at
developers and often lacks polish. Now we're telling developers to put
operator/user documentation into /developer?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160307/8397d021/attachment.html>


More information about the OpenStack-dev mailing list