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 _______________________________________________ OpenStack-operators mailing list [email protected] http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators
