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.
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.
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) keystone- manage. .. - perhaps that should be redirect to Admin guide and maintained there?
Optionally there should be third one for such clients as nova-manage/
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: /www.openstack. org/software/ project- navigator/ would be nice
-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:/
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.