[Openstack-docs] Status of renaming!

Nermina Miller nerminamiller at gmail.com
Thu Sep 12 13:16:38 UTC 2013


Thank you all!


On Thu, Sep 12, 2013 at 9:05 AM, Anne Gentle
<annegentle at justwriteclick.com>wrote:

>
>
>
> On Thu, Sep 12, 2013 at 1:39 AM, Andreas Jaeger <aj at suse.com> wrote:
>
>> On 09/12/2013 02:40 AM, Anne Gentle wrote:
>> >
>> >
>> >
>> > On Mon, Sep 9, 2013 at 5:53 AM, Andreas Jaeger <aj at suse.com
>> > <mailto:aj at suse.com>> wrote:
>> >
>> >     On 09/09/2013 09:32 AM, Andreas Jaeger wrote:
>> >     > We really need to double check that the books are correctly
>> >     published on
>> >     > the website - and links point from trunk/index.html to the new
>> >     version.
>> >     >
>> >     > Christian and myself are giving this a first try but please double
>> >     check
>> >     > after our patches have gone in that everything really works,
>> >
>> >     Some of the manuals are building and publishing now, some reviews
>> are
>> >     open for others - and then there are a couple of locations to
>> update in
>> >     index.html where I'm not sure where the books get published:
>> >
>> >     Currently trunk/index.html patch has these paths which are wrong:
>> >     http://docs.openstack.org/trunk/admin-guide-cloud/admin/content/:
>> Does
>> >     not exist
>> >     http://docs.openstack.org/trunk/openstack-network/admin/content/ :
>> >     Old name
>> >     http://docs.openstack.org/trunk/openstack-ha/content/index.html :
>> >     Old name
>> >     http://docs.openstack.org/trunk/security-guide/content/ : Does not
>> exist
>> >
>> >     For many guides patches have been sent to fix problems Christian and
>> >     myself noticed in pom.xml. These need a review and then
>> trunk/index.html
>> >     might need updating.
>> >
>> >     The Cloud Administrators Guide currently puzzles me. Anybody knows
>> what
>> >     the new URL is? Is there a way for me to figure this out directly on
>> >     docs.o.o?
>> >
>> >
>> > I'll let you know how I'd figure it out:
>> >
>> > 1. pom.xml has
>> >
>> >
>> <targetDirectory>${basedir}/target/docbkx/webhelp/admin-guide-cloud</targetDirectory>
>> >
>> >                             <webhelpDirname>admin</webhelpDirname>
>> >
>> > that means it'll be locally built to
>> > target/docbkx/webhelp/admin-guide-cloud/admin/.
>> >
>> > But, in the Jenkins job definition in openstack-infra/config/
>> > modules/openstack_project/files/jenkins_job_builder/config/manuals.yaml
>> > you'll see:
>> >
>> >
>> >
>> > - ftp:
>> >           site: docs.openstack.org <http://docs.openstack.org>
>> >           source: 'doc/admin-guide-cloud/target/docbkx/webhelp/**'
>> >           target: 'cloud-admin'
>> >           remove-prefix: 'doc/admin-guide-cloud/target/docbkx/webhelp/'
>> >           excludes: '**/*.xml,**/null*'
>> >
>> > So it's probably going to
>> >
>> > docs.openstack.org/admin-guide-cloud/admin/cloud-admin
>> > <http://docs.openstack.org/admin-guide-cloud/admin/cloud-admin>
>> >
>> > Except it's not!
>> >
>> > So I go to Jenkins to look at the log of the job itself.
>> >
>> > https://jenkins01.openstack.org/view/Openstack-manuals/
>> >
>> > Looking at that and the changing directory commands in the log, it's
>> > going to
>> >
>> > http://docs.openstack.org/cloud-admin/admin-guide-cloud/content/
>> >
>> > I think we want it to go to /cloud-admin/content.
>> >
>> > So, change the pom.xml and it should be good to go.
>>
>> Anne, we discussed this on Tuesday on IRC and there you suggested to
>> change to /admin-guide-cloud/content and I thus proposed the following
>> for the Jenkins job: https://review.openstack.org/#/c/45938/
>>
>> If we want to got to /cloud-admin/content we need to change the Jenkins
>> job in another way, the pom.xml is fine AFAIU,
>>
>
>
> Ohhh I thought this looked familiar. :)
>
> I have to admit, I like /cloud-admin/content better, but not enough to do
> a 301 redirect from what you've done, so thanks for that!
>
> Anne
>
>
>> Andreas
>> --
>>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>>
>
>
>
> --
> Anne Gentle
> annegentle at justwriteclick.com
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
>


-- 
Thank you!

Nermina Miller
Tech Writer and Editor
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130912/827a1cb9/attachment-0001.html>


More information about the Openstack-docs mailing list