Open Stack

I'm fine with that -

you can add that to the bug.

I will actually create multiple bugs – one for each folder – so that it's smaller changes.

Diane
----------------------------------------------
Diane Fleming
Software Developer II - US
diane.fleming at rackspace.com
Cell  512.323.6799
Office 512.874.1260
Skype drfleming0227
Google-plus diane.fleming at gmail.com

From: Anne Gentle <annegentle at justwriteclick.com<mailto:annegentle at justwriteclick.com>>
Date: Tuesday, September 3, 2013 3:41 PM
To: Diane Fleming <diane.fleming at rackspace.com<mailto:diane.fleming at rackspace.com>>
Cc: "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>>
Subject: Re: [Openstack-docs] Folder renaming in openstack-manuals

I think this will be a big helper. You will have to also ensure the jobs in the openstack-infra/config repo reflect the new folder locations for the pom.xml files. It's a lot of work, I'm happy to help out.

Since we'll have to touch so many build jobs, I wonder if now's the time to get rid of /trunk/ and just publish to the book name for the books that will not be released as a named release any longer? I've disliked the term "trunk" for a while now and I'd like to seize the opportunity if it's not too much scope creep.

Thanks!
Anne



On Tue, Sep 3, 2013 at 2:35 PM, Diane Fleming <diane.fleming at rackspace.com<mailto:diane.fleming at rackspace.com>> wrote:
Oh, and here is the bug if you want to make any comments about this change – thanks!

https://bugs.launchpad.net/openstack-manuals/+bug/1220407


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: Diane Fleming <diane.fleming at rackspace.com<mailto:diane.fleming at rackspace.com>>
Date: Tuesday, September 3, 2013 2:33 PM
To: "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>>
Subject: Folder renaming in openstack-manuals

Hello, just want to alert you about an upcoming change.

The folders in the openstack-manuals repo are oddly named. First off, they really don't require an "openstack" prefix because they are in the openstack-manuals repo.

Secondly, they don't follow a naming convention.

I'm opening a bug to rename them by using the following naming convention:

<book-type>-<project>
or
<book-type>-<audience>


basic-install -> install-guide-basic
cli-guide (going away)
common
NEW-> admin-guide-cloud (Cloud Administrators Guide) new comprehensive admin guide (the cloud part just so we know it's the comprehensive guide)
docbkx-example
openstack-block-storage-admin -> becomes a chapter in the new admin-guide-cloud
openstack-compute-admin -> becomes a chapter in admin-guide-cloud
openstack-config -> config-reference
openstack-ha -> high-availability-guide
openstack-image-> image-guide
openstack-install -> install-guide
openstack-network-connectivity-admin -> admin-guide-network – must remain a separate guide (for now)
openstack-object-storage-admin -> becomes a chapter in admin-guide-cloud
openstack-security -> security-guide
openstack-training -> training-guide
openstack-user -> user-guide
openstack-user-admin -> user-guide-admin

Does anyone have any issues/concerns?

thanks!

Diane

_______________________________________________
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>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130903/cbf3dce4/attachment-0001.html>