[OASIS Issue Tracker] Commented: (CAMP-39) Discovery Features

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/CAMP-39?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=32199#action_32199 ] 

Alex Heneveld commented on CAMP-39:
-----------------------------------

I would advocate using  /apidoc  as an entry point for "documenting" these items.  "documenting" here means doing so in a way which has both machine-navigable lists of attributes, and human-readable "description" fields.  This allows it to be used in a nice GUI as well as machine discovery tools.

(BTW tools like "swagger" does a nice job of generating this automatically.)

+1 to extensions being "discoverable" in this sense

> Discovery Features
> ------------------
>
>                 Key: CAMP-39
>                 URL: http://tools.oasis-open.org/issues/browse/CAMP-39
>             Project: OASIS Cloud Application Management for Platforms (CAMP) TC
>          Issue Type: New Feature
>          Components: Spec
>            Reporter: Adrian Otto
>            Assignee: Adrian Otto
>            Priority: Critical
>
> This issue is intended as a collection of all the different resources that require a discovery feature in CAMP. Individual issues should be opened for each of these. This issue is for the purpose of thinking of them as a group so our solution is consistent among all of them.
> Discoverable Entities:
> - Metadata. Reference:  CAMP-1
> - Data Representation Formats (other than JSON). Reference: CAMP-14
> - Extensions. Reference: CAMP-10

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira