[jira] [Commented] (CLOUDSTACK-94) API command, listIsos documentation clarity

["Joe Brockmeier (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/CLOUDSTACK-94?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13590995#comment-13590995 ] 

Joe Brockmeier commented on CLOUDSTACK-94:
------------------------------------------

This one hasn't been touched since September 2012 - is this in process or should we move it to "unassigned"?
                
> API command, listIsos documentation clarity
> -------------------------------------------
>
>                 Key: CLOUDSTACK-94
>                 URL: https://issues.apache.org/jira/browse/CLOUDSTACK-94
>             Project: CloudStack
>          Issue Type: Bug
>      Security Level: Public(Anyone can view this level - this is the default.) 
>          Components: Doc
>    Affects Versions: pre-4.0.0
>         Environment: This document:
> http://download.cloud.com/releases/3.0.0/api_3.0.0/root_admin/listIsos.html
>            Reporter: Jesse Callaway
>            Assignee: Jessica Tomechak
>            Priority: Minor
>              Labels: api, documentation
>             Fix For: 4.1.0
>
>   Original Estimate: 20m
>  Remaining Estimate: 20m
>
> Bug description:
> The isofilter parameter copy does not list all valid arguments. Where they are listed, it is confusing to read.
> In particular, the "all" argument should be listed.
> Related bug:
> The description of the "id" parameter is incorrect. It does not list all iso's by id. It is the id of the ISO to be listed. The word _all_ in this context is not only confusing, but is incorrect, since a uuid is universally unique.
> Further consideration:
> "isofilter=all" should be the default behavior. However, that is not a documentation bug, but a usability preference.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira