[Openstack-operators] [OpenStack-docs] [doc] Operations Guide removal

Doug Hellmann doug at doughellmann.com
Wed Jul 19 10:51:25 UTC 2017


Excerpts from Blair Bethwaite's message of 2017-07-19 20:40:25 +1000:
> Hi Alex,
> 
> I just managed to take a half hour to look at this and have a few
> questions/comments towards making a plan for how to proceed with
> moving the Ops Guide content to the wiki...
> 
> 1) Need to define wiki location and structure. Curiously at the moment
> there is already meta content at
> https://wiki.openstack.org/wiki/Documentation/OpsGuide, Maybe the
> content could live at https://wiki.openstack.org/wiki/OpsGuide? I
> think it makes sense to follow the existing structure with possible
> exception of culling wrong / very-out-of-date content (but perhaps
> anything like that should be done as a later step and keep it simple
> aiming for a "like-for-like" migration to start with)...?

Yes, I would recommend moving the existing content and then making any
major changes to it.

> 2) Getting the content into the wiki. Looks like there is no obvious
> up-to-date RST import functionality for MediaWiki. Pandoc seems as
> though it might support some useful conversions but I didn't try this
> yet and don't have any experience with it - can anyone say with
> authority whether it is worth pursuing?

I can't say with authority myself, but I can refer to Anne as an
authority. :-)

> 3) Future management - obvious can of worms given this is much better
> addressed by all the tooling and scaffolding the docs team already
> provides around the repos... but nonetheless some expectations may
> need to be set upfront to avoid future pain.

What sort of issues do you foresee?

Doug



More information about the OpenStack-operators mailing list