Open Stack

Looks like we all agree that Anne's suggestion is the best approach, so
let's go with that.

During the migration period, if a patch is submitted for the Cloud Admin
Guide, please ask the contributor to submit the change for both the XML and
RST versions of the doc.

Thanks!

Brian

On 5 June 2015 at 02:16, Ildikó Váncsa <ildiko.vancsa at ericsson.com> wrote:

> Hi All,
>
> We have one patch for Ceilometer now, most probably we will not have that
> many in the near future, but it would be nice, if we could submit that few.
> Just to keep the docs contributors eager and motivated. :)
>
> Thanks,
> Ildikó
>
> > -----Original Message-----
> > From: Sutton, Harry (HP Converged Systems & Solutions ERT)
> > [mailto:harry.sutton at hp.com]
> > Sent: June 04, 2015 15:59
> > To: Brian Moss; Anne Gentle
> > Cc: openstack-docs at lists.openstack.org
> > Subject: Re: [OpenStack-docs] Freezing Cloud Admin Guide XML
> > development
> >
> > Apologies in advance for top-posting, but I couldn't figure out the
> convention
> > from this email ;-) ;-) ;-) so I took the lazy / easy way out.
> >
> > Anyway, as one of the volunteers on this conversion, I don't have any
> > problem with the dual approach as long as there isn't a high volume of
> > patches submitted (and I wouldn't expect there to be.)
> >
> > My $.02.
> >
> >     /Harry
> >
> > On 06/03/2015 09:45 PM, Brian Moss wrote:
> >
> > On 4 June 2015 at 11:39, Anne Gentle
> > <annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>>
> > wrote:
> >
> >
> > On Wed, Jun 3, 2015 at 8:04 PM, Brian Moss
> > <kallimachos at gmail.com<mailto:kallimachos at gmail.com>> wrote:
> > Hi all,
> >
> > We're kicking off the conversion of the Cloud Admin Guide from XML to RST
> > (https://wiki.openstack.org/wiki/Documentation/Migrate#Cloud_Admin_Gu
> > ide_Migration).  While we're doing this, we'd like to put a temporary
> freeze
> > on development of the guide so we don't have the XML changing beneath
> > us.  To this end, could everyone please hold off on making changes to the
> > Cloud Admin Guide until we announce the conversion is complete.
> >
> >
> > Hi Brian,
> >
> > One thing we did due to the long migration times for the user guides was
> to
> > request a change to both the XML and RST in any patchset during the
> > migration period. There weren't too many of those, but you may consider
> it
> > for the time period so the freeze isn't preventing improved content in
> the
> > meantime.
> >
> > Since we needed 3 months to migrate the other two guides (mid-Feb to mid-
> > May), and this release is only 5.5 months, you should probably try
> either not
> > to freeze or to migrate more quickly.
> >
> > Just a consideration based on past experience -- you may have already
> found
> > a way to migrate more content quickly.
> > Thanks,
> > Anne
> >
> >
> > Hi Anne,
> >
> > That's a good idea.  I'm feeling my way somewhat here, so having the
> benefit
> > of past experience is much appreciated.
> >
> > User Guide team et al., how do you feel about requesting XML and RST for
> > patches while we're doing the migration rather than freezing the doc?
> >
> > -Brian
> >
> >
> >
> >
> > If you happen to find yourself reviewing an XML Cloud Admin Guide patch
> in
> > the next few weeks, please let the author know about the freeze and ask
> > them to resubmit an RST patch when the conversion is finished.
> >
> > Thanks!
> >
> > Brian
> >
> > _______________________________________________
> > 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
> >
> >
> >
> >
> > --
> > Anne Gentle
> > annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>
> >
> >
> >
> >
> > _______________________________________________
> > 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150605/a29cc1aa/attachment.html>