<div dir="ltr">I have privileges to edit wiki pages on <a href="http://openstack.org">openstack.org</a> so you could send me a few converted pages (perhaps ones that link to each other) and I could upload them and we can all look at the result and see if we like it. Happy to do that.<div><br></div><div>Chris</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Aug 13, 2017 at 9:44 PM, Yuki Kasuya <span dir="ltr"><<a href="mailto:yu-kasuya@kddi-research.jp" target="_blank">yu-kasuya@kddi-research.jp</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
How about that if some directives can be ignored (using pandoc), I'll create one new ops-guide page as a example on wiki. After that could you review it ? I don't know any approval to create/edit pages on wiki. Or I can send you converting files. Attached is a converting example.<br>
And let's discuss which url is good for new ops-guides like below. Which is good using file name or first header as url of wiki? And which directory is fine?<br>
<br>
<a href="https://wiki.openstack.org/wiki/OpsGuide" rel="noreferrer" target="_blank">https://wiki.openstack.org/wik<wbr>i/OpsGuide</a> (as index)<br>
<a href="https://wiki.openstack.org/wiki/OpsGuide/acknowledgements" rel="noreferrer" target="_blank">https://wiki.openstack.org/wik<wbr>i/OpsGuide/acknowledgements</a><br>
<a href="https://wiki.openstack.org/wiki/OpsGuide/app-crypt" rel="noreferrer" target="_blank">https://wiki.openstack.org/wik<wbr>i/OpsGuide/app-crypt</a><br>
...<br>
<br>
Best regards,<br>
Yuki<span class=""><br>
<br>
On 8/12/17 23:38, Chris Morgan wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
I just got back from the ops meetup in Mexico City and I think I<br>
volunteered to help with this ops guide transition and maintaining it on<br>
the wiki. So if the current output of the conversion is available<br>
anywhere for review I could try being a proofreader for it. It seems<br>
there is approval to put it as is on the wiki, what does that require?<br>
<br>
I am not very familiar with the docs build process so if we are still<br>
attempting to get a minimally viable conversion I may be able to help<br>
but will need more time to come up to speed with that.<br>
<br>
Chris<br>
<br>
On Thu, Aug 10, 2017 at 8:47 AM, Anne Gentle<br></span>
<<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a> <mailto:<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwritecl<wbr>ick.com</a>>><span class=""><br>
wrote:<br>
<br>
    On Thu, Aug 10, 2017 at 3:09 AM, Yuki Kasuya<br></span><span class="">
    <<a href="mailto:yu-kasuya@kddi-research.jp" target="_blank">yu-kasuya@kddi-research.jp</a> <mailto:<a href="mailto:yu-kasuya@kddi-research.jp" target="_blank">yu-kasuya@kddi-researc<wbr>h.jp</a>>> wrote:<br>
    > Hi,<br>
    ><br>
    ><br>
    > On 7/19/17 23:51, Anne Gentle wrote:<br>
    >><br>
    >> On Wed, Jul 19, 2017 at 5:51 AM, Doug Hellmann<br></span>
    <<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a> <mailto:<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>><wbr>><span class=""><br>
    >> wrote:<br>
    >>><br>
    >>> Excerpts from Blair Bethwaite's message of 2017-07-19 20:40:25<br>
    +1000:<br>
    >>>><br>
    >>>> Hi Alex,<br>
    >>>><br>
    >>>> I just managed to take a half hour to look at this and have a few<br>
    >>>> questions/comments towards making a plan for how to proceed with<br>
    >>>> moving the Ops Guide content to the wiki...<br>
    >>>><br>
    >>>> 1) Need to define wiki location and structure. Curiously at the<br>
    moment<br>
    >>>> there is already meta content at<br>
    >>>> <a href="https://wiki.openstack.org/wiki/Documentation/OpsGuide" rel="noreferrer" target="_blank">https://wiki.openstack.org/wik<wbr>i/Documentation/OpsGuide</a><br></span>
    <<a href="https://wiki.openstack.org/wiki/Documentation/OpsGuide" rel="noreferrer" target="_blank">https://wiki.openstack.org/wi<wbr>ki/Documentation/OpsGuide</a>>, Maybe the<span class=""><br>
    >>>> content could live at <a href="https://wiki.openstack.org/wiki/OpsGuide" rel="noreferrer" target="_blank">https://wiki.openstack.org/wik<wbr>i/OpsGuide</a><br></span>
    <<a href="https://wiki.openstack.org/wiki/OpsGuide" rel="noreferrer" target="_blank">https://wiki.openstack.org/wi<wbr>ki/OpsGuide</a>>? I<div><div class="h5"><br>
    >>>> think it makes sense to follow the existing structure with possible<br>
    >>>> exception of culling wrong / very-out-of-date content (but perhaps<br>
    >>>> anything like that should be done as a later step and keep it<br>
    simple<br>
    >>>> aiming for a "like-for-like" migration to start with)...?<br>
    >>><br>
    >>><br>
    >>> Yes, I would recommend moving the existing content and then<br>
    making any<br>
    >>> major changes to it.<br>
    >>><br>
    >>>> 2) Getting the content into the wiki. Looks like there is no<br>
    obvious<br>
    >>>> up-to-date RST import functionality for MediaWiki. Pandoc seems as<br>
    >>>> though it might support some useful conversions but I didn't<br>
    try this<br>
    >>>> yet and don't have any experience with it - can anyone say with<br>
    >>>> authority whether it is worth pursuing?<br>
    >>><br>
    >>><br>
    >>> I can't say with authority myself, but I can refer to Anne as an<br>
    >>> authority. :-)<br>
    >><br>
    >><br>
    >> Ha, well, I think Pandoc is the one to try first, let's say that for<br>
    >> starters.<br>
    >><br>
    >> Here's what I was thinking:<br>
    >> If you're interested in the export, run an experiment with Pandoc to<br>
    >> convert from RST to Mediawiki.<br>
    >><br>
    >> <a href="http://pandoc.org/demos.html" rel="noreferrer" target="_blank">http://pandoc.org/demos.html</a><br>
    >><br>
    >> You'll likely still have cleanup but it's a start. Only convert<br>
    >> troubleshooting to start, which gets the most hits:<br></div></div>
    <a href="http://docs.openstack.org/" rel="noreferrer" target="_blank">docs.openstack.org/</a> <<a href="http://docs.openstack.org/" rel="noreferrer" target="_blank">http://docs.openstack.org/</a>><div><div class="h5"><br>
    >> ops-guide/ops-network-troubles<wbr>hooting.html<br>
    >> Then see how much you get from Pandoc.<br>
    >><br>
    ><br>
    > I tried to convert all docs under ops-guide dir using pandoc. Like below,<br>
    > toctree,term and some directives doesn't work after converting. But, at<br>
    > glance, almost fine after converting.<br>
    > If you don't mind, I'll able to create wiki pages of ops-guide.<br>
    ><br>
    > xxx@devstack02:~/work/openstac<wbr>k-manuals/doc/ops-guide/<wbr>source$ pandoc<br>
    > index.rst -t mediawiki -o index<br>
    > .wiki<br>
    > pandoc: ignoring unknown directive: toctree "source" (line 58, column 1)<br>
    > pandoc: ignoring unknown role :term: in "source" (line 20, column 13)<br>
    > pandoc: ignoring unknown role :term: in "source" (line 19, column 59)<br>
    ><br>
<br>
    Fantastic! That's better that I thought it would do, I'll admit. :)<br>
    You may have figured this out, but :term: [1] is for glossary entries,<br>
    and a toctree directive [2] is for a table of contents insertion.<br>
<br>
    Thanks for testing the theory and making it practical.<br>
<br>
    Anne<br>
<br>
    1. <a href="http://www.sphinx-doc.org/en/stable/markup/inline.html" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/s<wbr>table/markup/inline.html</a><br>
    <<a href="http://www.sphinx-doc.org/en/stable/markup/inline.html" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/<wbr>stable/markup/inline.html</a>><br>
    2. <a href="http://www.sphinx-doc.org/en/stable/markup/toctree.html" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/s<wbr>table/markup/toctree.html</a><br>
    <<a href="http://www.sphinx-doc.org/en/stable/markup/toctree.html" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/<wbr>stable/markup/toctree.html</a>><br>
<br>
<br>
<br>
    >><br>
    >> Hope this helps -<br>
    >> Anne<br>
    >><br>
    >>><br>
    >>>> 3) Future management - obvious can of worms given this is much better<br>
    >>>> addressed by all the tooling and scaffolding the docs team already<br>
    >>>> provides around the repos... but nonetheless some expectations may<br>
    >>>> need to be set upfront to avoid future pain.<br>
    >>><br>
    >>><br>
    >>> What sort of issues do you foresee?<br>
    >>><br>
    >>> Doug<br>
    >>><br>
    >>> ______________________________<wbr>_________________<br>
    >>> OpenStack-operators mailing list<br>
    >>> <a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@lists.open<wbr>stack.org</a><br></div></div>
    <mailto:<a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@li<wbr>sts.openstack.org</a>><br>
    >>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-operators</a><span class=""><br>
    <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cg<wbr>i-bin/mailman/listinfo/opensta<wbr>ck-operators</a>><br>
    >><br>
    >><br>
    >><br>
    >><br>
    ><br>
    > --<br>
    > ------------------------------<wbr>---------------<br>
    > KDDI Research, Inc.<br>
    > Integrated Core Network Control<br>
    > And Management Laboratory<br>
    > Yuki Kasuya<br></span>
    > <a href="mailto:yu-kasuya@kddilabs.jp" target="_blank">yu-kasuya@kddilabs.jp</a> <mailto:<a href="mailto:yu-kasuya@kddilabs.jp" target="_blank">yu-kasuya@kddilabs.jp</a>><br>
    > <a href="tel:%2B81%2080%209048%208405" value="+818090488405" target="_blank">+81 80 9048 8405</a> <tel:%2B81%2080%209048%208405><span class=""><br>
<br>
<br>
<br>
    --<br>
<br>
    Read my blog: justwrite.click<br></span>
    Subscribe to Docs|Code: <a href="http://docslikecode.com" rel="noreferrer" target="_blank">docslikecode.com</a> <<a href="http://docslikecode.com" rel="noreferrer" target="_blank">http://docslikecode.com</a>><span class=""><br>
<br>
    ______________________________<wbr>_________________<br>
    OpenStack-operators mailing list<br>
    <a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@lists.open<wbr>stack.org</a><br></span>
    <mailto:<a href="mailto:OpenStack-operators@lists.openstack.org" target="_blank">OpenStack-operators@li<wbr>sts.openstack.org</a>><br>
    <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-operators</a><br>
    <<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators" rel="noreferrer" target="_blank">http://lists.openstack.org/cg<wbr>i-bin/mailman/listinfo/opensta<wbr>ck-operators</a>><br>
<br>
<br>
<br><span class="HOEnZb"><font color="#888888">
<br>
--<br>
Chris Morgan <<a href="mailto:mihalis68@gmail.com" target="_blank">mihalis68@gmail.com</a> <mailto:<a href="mailto:mihalis68@gmail.com" target="_blank">mihalis68@gmail.com</a>>><br>
</font></span></blockquote><div class="HOEnZb"><div class="h5">
<br>
-- <br>
------------------------------<wbr>---------------<br>
KDDI Research, Inc.<br>
Integrated Core Network Control<br>
And Management Laboratory<br>
Yuki Kasuya<br>
<a href="mailto:yu-kasuya@kddilabs.jp" target="_blank">yu-kasuya@kddilabs.jp</a><br>
<a href="tel:%2B81%2080%209048%208405" value="+818090488405" target="_blank">+81 80 9048 8405</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature">Chris Morgan <<a href="mailto:mihalis68@gmail.com" target="_blank">mihalis68@gmail.com</a>></div>
</div>