[openstack-dev] Improving OpenStack documentation around RabbitMQ

Michael Klishin mklishin at pivotal.io
Tue Apr 28 12:58:46 UTC 2015


Hi, 

I'm a RabbitMQ engineering team member and we'd like to help improve OpenStack docs
around it.

I've been reading the docs and making notes of what can be improved. We'd be happy
to contribute the changes. However, we're not very familiar with the OpenStack development
process and have a few questions before we start.

As far as I understand, OpenStack Kilo is about to ship. Does this mean we can only contribute
documentation improvements for the release after it? Are there maintenance releases that doc improvements
could go into? If so, how is this reflected in repository  branches?

Should the changes we propose be discussed on this list or in GitHub issues [1]?

Finally, we are considering adding a doc guide dedicated to OpenStack on rabbitmq.com (we have one for EC2,
for instance). Note that we are not looking
to replace what's on docs.openstack.org, only provide a guide that can go into more details.
Does this sound like a good idea to the OpenStack community? Should we keep everything on docs.openstack.org?
Would it be OK if we link to rabbitmq.com guides in any changes we contribute? I don't think OpenStack Juno
docs have a lot of external links: is that by design?

Thanks.

1. https://github.com/openstack/openstack-manuals 
--  
MK  

Staff Software Engineer, Pivotal/RabbitMQ  





More information about the OpenStack-dev mailing list