You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@syncope.apache.org by "Francesco Chicchiriccò (JIRA)" <ji...@apache.org> on 2013/10/15 10:39:44 UTC
[jira] [Updated] (SYNCOPE-151) Document RESTful services
[ https://issues.apache.org/jira/browse/SYNCOPE-151?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Francesco Chicchiriccò updated SYNCOPE-151:
-------------------------------------------
Component/s: documentation
Description:
Provide dynamic documentation for RESTful services: the easiest and most effective way seems to be via XSLT processing of WADL information, [auto-generated by CXF|http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-WADLAutoGeneration].
Relevant discussion on dev ML: http://syncope-dev.1063484.n5.nabble.com/DISCUSS-Document-RESTful-APIs-td5714317.html
was:
Update in order to profit from Spring >= 3.1 new features, like as for example REST service discoverability.
More information:
* http://www.baeldung.com/2011/11/13/rest-service-discoverability-with-spring-part-5/
* http://www.smartjava.org/content/how-should-rest-services-be-documented
* http://swagger.wordnik.com/
* http://panbhatt.blogspot.in/2012/07/spring-mvc-wadl-generation.html
Fix Version/s: (was: 2.0.0)
1.2.0
1.1.5
Assignee: Francesco Chicchiriccò
Summary: Document RESTful services (was: Enlist RESTful services)
> Document RESTful services
> -------------------------
>
> Key: SYNCOPE-151
> URL: https://issues.apache.org/jira/browse/SYNCOPE-151
> Project: Syncope
> Issue Type: Improvement
> Components: core, documentation
> Reporter: Francesco Chicchiriccò
> Assignee: Francesco Chicchiriccò
> Labels: rest
> Fix For: 1.1.5, 1.2.0
>
>
> Provide dynamic documentation for RESTful services: the easiest and most effective way seems to be via XSLT processing of WADL information, [auto-generated by CXF|http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-WADLAutoGeneration].
> Relevant discussion on dev ML: http://syncope-dev.1063484.n5.nabble.com/DISCUSS-Document-RESTful-APIs-td5714317.html
--
This message was sent by Atlassian JIRA
(v6.1#6144)