Comment 13 for bug 1220407

Revision history for this message
Anne Gentle (annegentle) wrote : Re: [Bug 1220407] Re: openstack-manuals: rename subfolders to use naming convention

Since the http://docs.openstack.org/trunk
/openstack-compute/admin/content/index.html URL is the most-visited page on
the site, we plan to redirect it as indicated in
https://docs.google.com/spreadsheet/ccc?key=0AhXvn1h0dcyYdGhtUTRhRkdvQzN0MEFrVnNsTk9pc0E#gid=0

However, the build for admin-guide-cloud is not yet working, sorry. Working
on it. https://bugs.launchpad.net/openstack-ci/+bug/1223065

On Mon, Sep 9, 2013 at 4:40 PM, Brant Knudson <email address hidden> wrote:

> The problem I'm having now is that when I generate the doccs for admin-
> guide-cloud, it's nothing like what's on http://docs.openstack.org/trunk
> /openstack-compute/admin/content/index.html . Trying to make updates,
> but it's hard to find where to make the change when the docs I generate
> locally don't look like what's on the published site.
>
> --
> You received this bug notification because you are a bug assignee.
> https://bugs.launchpad.net/bugs/1220407
>
> Title:
> openstack-manuals: rename subfolders to use naming convention
>
> Status in OpenStack Manuals:
> Fix Released
>
> Bug description:
> 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.
>
> I will remove the parent folders doc/src/docbkx from the child book
> folders.
>
> I will also remove the "src" subdir in those book folders that have
> them.
>
> Finally, the book folders don't follow a naming convention.
>
> I plan 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
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/openstack-manuals/+bug/1220407/+subscriptions
>