API references don't have parameter's range

Bug #1390531 reported by Masahito Muroi on 2014-11-07
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-doc-tools
Medium
Unassigned

Bug Description

Parameters in api references rack range of the parameters.
All parameters in current refernces only has types of the param, but parameters usually have some limitations for thier format.

For example:
 length of server's name specified in creates server API has to range 1-255

tags: added: api-site
Tom Fifield (fifieldt) on 2014-11-11
affects: openstack-manuals → openstack-api-site
Anne Gentle (annegentle) wrote :

Would love to see these documented, thanks. Let me know if you need help implementing.

Changed in openstack-api-site:
status: New → Confirmed
importance: Undecided → Medium
Masahito Muroi (muroi-masahito) wrote :

I'm wondering where I document these in the references. To append a new column at parameter table, updating maven-plugin is needed. However, you said the plugin isn't updated frequently.

Anne Gentle (annegentle) wrote :

We are moving to Swagger (Open API) instead of WADL. Apologies for the delayed response. So ideally the swagger files would contain this info:

http://developer.openstack.org/draft/swagger

However, we'll have to complete the migration for that task to be completed.

Changed in openstack-api-site:
status: Confirmed → Triaged
Anne Gentle (annegentle) wrote :

This could go into the RST + YAML parameters tables somehow... let's track in openstack-doc-tools.

Changed in openstack-doc-tools:
status: New → Confirmed
no longer affects: openstack-api-site
Changed in openstack-doc-tools:
importance: Undecided → Medium
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers