Comment 6 for bug 1490484

Revision history for this message
KATO Tomoyuki (kato-tomoyuki) wrote :

I also see your point, Kostiantyn. My thought inline, as of now.

> (minimum) to have a sort rule every project that has CLI to have page referenced.
> That means that Identity page is to be there and has a link to OpenStack client

I think it is worth to try it, but please keep in mind that some OSC command objects provide a few services for better user experience.

For example: http://docs.openstack.org/developer/python-openstackclient/command-objects/availability-zone.html

And, it should be done in the python-openstackclient repository.

> 1) every page in http://docs.openstack.org/cli-reference/ to have two links '<name of project> in OSC and second one to point to individual client (until it is obsoleted/removed like Keystone)
Optionally there should be third one for such clients as nova-manage/keystone-manage... - perhaps that should be redirect to Admin guide and maintained there?

agree. it should be more automated way than now as possible.

> 2) it is not user friendly that CLI reference guide doesn't have project name but only . There are two aspects of that:
-it is a bit hard for someone to find Nova/Glance/ in current list and it is not straightforward to know every name of project
Maybe in short-term link to https://www.openstack.org/software/project-navigator/ would be nice

For user experience, especially non-developer user, we intentionally don't use "project name" at the official docs. It is, however, time to reconsider its convention.