Excerpts from Stephen Finucane's message of 2017-08-02 16:35:23 +0100: > On Wed, 2017-08-02 at 09:28 -0600, Chris Friesen wrote: > > On 08/02/2017 09:22 AM, Stephen Finucane wrote: > > > On Wed, 2017-08-02 at 09:55 -0500, Matt Riedemann wrote: > > > > 3. The patch for the import of the admin guide [8] is missing some CLI > > > > specific pages which are pretty useful given they aren't documented > > > > anywhere else, like the forced_host part of the compute API [9]. > > > > Basically anything that's cli-nova-* in the admin guide should be in the > > > > Nova docs. It's also missing the compute-flavors page [10] which is > > > > pretty important for using OpenStack at all. > > > > > > This is a tricky one. Based on previous discussions with dhellmann, the > > > plan > > > seems to be to replace any references to 'nova xxx' or 'openstack xxx' > > > commands > > > (i.e. commands using python-novaclient or python-openstackclient) in > > > favour > > > of > > > 'curl'-based requests. The idea here is that the Python clients are not > > > the > > > only clients available, and we shouldn't be "mandating" their use by > > > referencing them in the docs. I get this, though I don't fully agree with > > > it > > > (who really uses curl?) > > > > Are we going to document the python clients elsewhere then? > > I think the docs would go into the respective python clients docs?
Right. I don't remember the details of the curl discussion, but I think what I was trying to say there was that the "nova" command line tool installed via python-novaclient should be documented as part of the openstack/python-novaclient repo rather than openstack/nova. A CLI reference for nova-manage, which I think is in openstack/nova, could be documented in openstack/nova. Basically, put the docs with the code, which is the whole point of this migration. Doug __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev