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

Alexandra Settle a.settle at outlook.com
Wed Jul 19 10:48:34 UTC 2017


Hey Blair!

Thanks for looking into this… Adding Mario and Erik who both also volunteered their time :)

1. I can say confidently that the content that lives at https://wiki.openstack.org/wiki/Documentation/OpsGuide can be removed. I am happy to do this if you would like to use this URL?
2. We (very successfully) used pandoc during our conversion from XML to RST. I would recommend it. I admit I haven’t tried converting to a mediaWiki format. But hey, worth trying… I guess the other option is manually copying across and editing. (Unless someone has a script lying around?)
3. It’s a good question, one I’m not really sure how to answer. The idea of pushing back to the wiki was so that the operators can own. Having the guide linked from docs.o.o will still ensure there is traffic, and people are able to edit. Perhaps the best idea for this is to use the documentation liaison for Ops as a first point of call? What do you think about that? Currently Robert Starmer is our liaison (https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation ) but seeing as we’re now making this more of an official ownership thing, we should be revisiting the responsibilities of the ops docs liaison?

Cheers,

Alex

On 7/19/17, 11:40 AM, "Blair Bethwaite" <blair.bethwaite at gmail.com> wrote:

    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)...?
    
    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?
    
    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.
    
    Cheers,
    
    On 15 July 2017 at 01:48, Alexandra Settle <a.settle at outlook.com> wrote:
    > Hi operators,
    >
    > Please be aware that I have proposed the following patch:
    > https://review.openstack.org/#/c/483937/
    >
    >
    >
    > This removes the Operations Guide from the openstack-manuals repo and will
    > no longer be accessible via docs.openstack.org after the patch merges.
    >
    > The documentation team does not have the resources to move the ops guide to
    > the wiki ourselves. If you are able to work on the migration, please check
    > out the ‘before-migration’ tag in the repo to access the deleted content.
    > [0]
    >
    > Once the ops guide is migrated to the wiki, we will help you add a redirect
    > so that the old link on docs.openstack.org will allow users to find the
    > content in the new location.
    >
    > Thanks,
    >
    > Alex
    >
    >
    >
    > [0] https://github.com/openstack/openstack-manuals/tree/before-migration
    >
    >
    > _______________________________________________
    > OpenStack-docs mailing list
    > OpenStack-docs at lists.openstack.org
    > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
    >
    
    
    
    -- 
    Cheers,
    ~Blairo
    



More information about the OpenStack-docs mailing list