[Fiware-webui] API's in Open Spec Delivarable: Apiary and client API's

[Torsten Spieldenner]

Good morning,

I have got new information about how to document our APIs in the new 
Open Spec deliverable.
Apiary is indeed only to be used for REST API's. For client side API's, 
we are currently investigating other tools to document these. The choice 
will possibly be Bikeshed (https://github.com/tabatkins/bikeshed ), the 
workflow will be similar to the one for the REST part:
We are going to describe our API's using this framework, generate the 
final Spec out of it, and upload the generated HTML to the Github repo 
on the gh-pages branch.

A very detailed list of how to deliver the Open Spec, the Open API's, 
and also the software and manuals deliverables afterwards was sent via 
the general FIWARE Mailinglist by Miguel yesterday:

  * https://docs.google.com/document/d/1wa15t2dSEucSA1xD7FyOLpP0ymihYYry0mhALV6GsXU

Best Regards,
Torsten

-- 
Torsten Spieldenner, M.Sc.

Tel.: +49 6 81 / 8 57 75 - 77 48
Fax.: +49 6 81 / 8 57 75 - 22 35

Internet: http://www.dfki.de/web/forschung/asr/

-------------------------------------------------------------
Deutsches Forschungszentrum fuer Kuenstliche Intelligenz GmbH
Trippstadter Strasse 122, D-67663 Kaiserslautern, Germany

Geschaeftsfuehrung:
Prof. Dr. Dr. h.c. mult. Wolfgang Wahlster (Vorsitzender)
Dr. Walter Olthoff

Vorsitzender des Aufsichtsrats:
Prof. Dr. h.c. Hans A. Aukes

Amtsgericht Kaiserslautern, HRB 2313
-------------------------------------------------------------

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-webui/attachments/20150807/49d6050f/attachment.html>