[Openstack-docs] convert the HA guide from AsciiDoc to DocBook

Matt Kassawara mkassawara at gmail.com
Sun May 25 02:36:42 UTC 2014


I'm using a blueprint instead of bugs for the installation guide
improvements. I think Anne wants to limit bugs to actual
defects/inaccuracies.


On Sat, May 24, 2014 at 6:16 PM, Nick Chase <nchase at mirantis.com> wrote:

> I'll get started on the structure and the rest of the chapters in the
> meantime.
>
> Question, though: I'd hate to try and put this through as one huge review;
> I'm thinking instead maybe one bug for the general changeover, then one bug
> each per chapter?  I can have everything ready to go to start, and once the
> book framework's been merged, we can run the chapter reviews concurrently
> to minimize disruption.
>
> Locally, I've already got the framework in and I'm adding chapters
> (keeping in mind that I'll have to re-add Joseph's content when he's
> finished).
>
> Thoughts?
>
> ----  Nick
>
>
> On Wed, May 21, 2014 at 6:59 PM, Joseph Robinson <
> joseph.robinson at rackspace.com> wrote:
>
>> +1 , One point though - I am working on a patch to the HA guide at the
>> moment. I will complete it ASAP so the conversion to XML can start.
>>
>> My patch: https://review.openstack.org/#/c/93856/2
>>
>> -Joseph Robinson
>>
>> On 22/05/2014 2:25 am, "Emilien Macchi" <emilien.macchi at enovance.com>
>> wrote:
>>
>> >+1
>> >
>> >Emilien Macchi
>> >
>> >On Wed 21 May 2014 06:00:46 PM CEST, Nicholas Chase wrote:
>> >> Only if I get to return the favor. :)
>> >>
>> >> ----  Nick
>> >>
>> >> On 5/21/2014 11:58 AM, Matt Kassawara wrote:
>> >>> Shall we play pin the -1 on the patch? :)
>> >>>
>> >>>
>> >>> On Wed, May 21, 2014 at 9:49 AM, Anne Gentle <anne at openstack.org
>> >>> <mailto:anne at openstack.org>> wrote:
>> >>>
>> >>>     Sounds good. If anyone has objections to the conversion, please
>> >>>     engage in the review.
>> >>>     Thanks,
>> >>>     Anne
>> >>>
>> >>>
>> >>>     On Wed, May 21, 2014 at 10:41 AM, Nicholas Chase
>> >>>     <nchase at mirantis.com <mailto:nchase at mirantis.com>> wrote:
>> >>>
>> >>>         Will do!  Give me a couple of days and it'll be in and ready
>> >>>for
>> >>>         review.
>> >>>
>> >>>         ----  Nick
>> >>>
>> >>>
>> >>>         On 5/21/2014 11:21 AM, Diane Fleming wrote:
>> >>>
>> >>>             Sure Nick, have at it!
>> >>>
>> >>>             /Diane/
>> >>>             /-----------------------------__-----------------/
>> >>>
>> >>>             Diane Fleming
>> >>>             Software Developer II - US
>> >>>             diane.fleming at rackspace.com
>> >>> <mailto:diane.fleming at rackspace.com>
>> >>>             Cell 512.323.6799 <tel:512.323.6799>
>> >>>             Office 512.874.1260 <tel:512.874.1260>
>> >>>             Skype drfleming0227
>> >>>             Google-plus diane.fleming at gmail.com
>> >>>             <mailto:diane.fleming at gmail.com>
>> >>>
>> >>>             From: Nick Chase <nchase at mirantis.com
>> >>>             <mailto:nchase at mirantis.com> <mailto:nchase at mirantis.com
>> >>>             <mailto:nchase at mirantis.com>>>
>> >>>
>> >>>             Date: Wednesday, May 21, 2014 9:22 AM
>> >>>             To: Diane Fleming <diane.fleming at rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>
>> >>>             <mailto:diane.fleming at __rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>>>
>> >>>             Cc: Anne Gentle <anne at openstack.org
>> >>>             <mailto:anne at openstack.org> <mailto:anne at openstack.org
>> >>>             <mailto:anne at openstack.org>>>,
>> >>>             Christian Berendt <berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>
>> >>>             <mailto:berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>>__>,
>> >>>             "openstack-docs at lists.__openstack.org
>> >>>             <mailto:openstack-docs at lists.openstack.org>
>> >>>             <mailto:openstack-docs at lists.__openstack.org
>> >>>             <mailto:openstack-docs at lists.openstack.org>>"
>> >>>             <Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>
>> >>>             <mailto:Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>>>
>> >>>
>> >>>             Subject: Re: [Openstack-docs] convert the HA guide from
>> >>>             AsciiDoc to DocBook
>> >>>
>> >>>             I'd be happy to do the conversion; it's something I'm
>> >>>             familiar with, I
>> >>>             have blocks of time where I can do it, and Diane, you can
>> >>>be
>> >>>             more useful
>> >>>             doing stuff that I can't, as a rule.
>> >>>
>> >>>             That said, if you're set on doing it yourself, I won't
>> stop
>> >>>             you. :)
>> >>>
>> >>>             Let me know.
>> >>>
>> >>>             ----  Nick
>> >>>
>> >>>
>> >>>             On Wed, May 21, 2014 at 9:52 AM, Diane Fleming
>> >>>             <diane.fleming at rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>
>> >>>             <mailto:diane.fleming at __rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>>> wrote:
>> >>>
>> >>>                  Yes please! I'm happy to convert it if everyone
>> >>>agrees.
>> >>>
>> >>>
>> >>>                  /Diane/
>> >>>                  /-----------------------------__-----------------/
>> >>>
>> >>>                  Diane Fleming
>> >>>                  Software Developer II - US
>> >>>             diane.fleming at rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>
>> >>>             <mailto:diane.fleming at __rackspace.com
>> >>>             <mailto:diane.fleming at rackspace.com>>
>> >>>                  Cell 512.323.6799 <tel:512.323.6799> <tel:
>> 512.323.6799
>> >>>             <tel:512.323.6799>>
>> >>>                  Office 512.874.1260 <tel:512.874.1260>
>> >>>             <tel:512.874.1260 <tel:512.874.1260>>
>> >>>                  Skype drfleming0227
>> >>>                  Google-plus diane.fleming at gmail.com
>> >>>             <mailto:diane.fleming at gmail.com>
>> >>>             <mailto:diane.fleming at gmail.__com
>> >>>             <mailto:diane.fleming at gmail.com>>
>> >>>
>> >>>                  From: Anne Gentle <anne at openstack.org
>> >>>             <mailto:anne at openstack.org> <mailto:anne at openstack.org
>> >>>             <mailto:anne at openstack.org>>>
>> >>>
>> >>>                  Date: Wednesday, May 21, 2014 8:48 AM
>> >>>                  To: Christian Berendt <berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>
>> >>>                  <mailto:berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>>__>
>> >>>                  Cc: "openstack-docs at lists.__openstack.org
>> >>>             <mailto:openstack-docs at lists.openstack.org>
>> >>>                  <mailto:openstack-docs at lists.__openstack.org
>> >>>             <mailto:openstack-docs at lists.openstack.org>>"
>> >>>                  <Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>
>> >>>                  <mailto:Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>>>
>> >>>
>> >>>                  Subject: Re: [Openstack-docs] convert the HA guide
>> >>>from
>> >>>             AsciiDoc to
>> >>>                  DocBook
>> >>>
>> >>>                  Glad you brought it up again. Last time someone asked
>> >>>a
>> >>>             year ago,
>> >>>                  here's how it went:
>> >>>
>> >>>
>> >>>
>> >>>
>> http://lists.openstack.org/__pipermail/openstack-docs/2013-__May/001630.
>> >>>html
>> >>>
>> >>>
>> >>>
>> >>><
>> http://lists.openstack.org/pipermail/openstack-docs/2013-May/001630.htm
>> >>>l>
>> >>>
>> >>>
>> >>>                  Seems like a recurring theme. Let's see what happens
>> >>>             this time around.
>> >>>
>> >>>                  Anne
>> >>>
>> >>>
>> >>>                  On Wed, May 21, 2014 at 8:41 AM, Christian Berendt
>> >>>                  <berendt at b1-systems.de <mailto:berendt at b1-systems.de
>> >
>> >>>             <mailto:berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>>__> wrote:
>> >>>
>> >>>                      Even I like AsciiDoc I would suggest to convert
>> >>>the
>> >>>             HA guide from
>> >>>                      AsciiDoc to DocBook. All other guides are written
>> >>>             in DocBox and
>> >>>                      I don't
>> >>>                      see any benefit of keeping the HA guide in
>> >>> AsciiDoc.
>> >>>
>> >>>                      Christian.
>> >>>
>> >>>                      --
>> >>>                      Christian Berendt
>> >>>                      Cloud Computing Solution Architect
>> >>>                      Mail: berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>
>> >>><mailto:berendt at b1-systems.de
>> >>>             <mailto:berendt at b1-systems.de>>
>> >>>
>> >>>
>> >>>                      B1 Systems GmbH
>> >>>                      Osterfeldstraße 7 / 85088 Vohburg /
>> >>>             http://www.b1-systems.de
>> >>>                      GF: Ralph Dehner / Unternehmenssitz: Vohburg /
>> AG:
>> >>>                      Ingolstadt,HRB 3537
>> >>>
>> >>>                      _________________________________________________
>> >>>                      Openstack-docs mailing list
>> >>>             Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>
>> >>>                      <mailto:Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>>
>> >>>
>> >>>
>> >>>
>> http://lists.openstack.org/__cgi-bin/mailman/listinfo/__openstack-docs
>> >>>
>> >>> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs>
>> >>>
>> >>>
>> >>>
>> >>>                  _________________________________________________
>> >>>                  Openstack-docs mailing list
>> >>>             Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>
>> >>>                  <mailto:Openstack-docs at lists.__openstack.org
>> >>>             <mailto:Openstack-docs at lists.openstack.org>>
>> >>>
>> >>>
>> http://lists.openstack.org/__cgi-bin/mailman/listinfo/__openstack-docs
>> >>>
>> >>> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs>
>> >>>
>> >>>
>> >>>
>> >>>
>> >>>     _______________________________________________
>> >>>     Openstack-docs mailing list
>> >>>     Openstack-docs at lists.openstack.org
>> >>>     <mailto:Openstack-docs at lists.openstack.org>
>> >>>
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>> >>>
>> >>>
>> >>
>> >> _______________________________________________
>> >> Openstack-docs mailing list
>> >> Openstack-docs at lists.openstack.org
>> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>> >
>>
>>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140524/0ba0f678/attachment-0001.html>


More information about the Openstack-docs mailing list