[
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)
