[Fiware-ngsi] URGENT Need to upload FI-WARE NGSI specification to the public Wiki

[Juanjo Hierro]

Hi all,

  We urgently need to upload the FI-WARE NGSI RESTful API specification to the public Wiki.

  As per now, you have used a Word document for the specification, but we need to translate it to Wiki pages.

  Since the FI-WARE NGSI RESTful API is an API whose operations are supported by several GEs in FI-WARE, the FI-WARE NGSI RESTful API specification will reside on a single wiki page referenced from each of the wiki pages of the GEs that support the API (concretely, from the "Open Specifications -> Open API Specifications" section that should exist in the wiki page that is describing the Architecture of the GE).   A given GE may not support all operations in FI-WARE NGSI interfaces, but that should be clear to the reader who has read the specific description of the architecture of that GE.

  I have created the placeholder for the FI-WARE NGSI RESTful API specification on the public wiki and make the necessary references to it from the pages linked to the "IoT Broker", "Configuration Management" and "Pub/Sub Broker" GEs (I know that we have to still fix the Architecture for the IoT Chapter backend, merging the "IoT Broker" and "Configuration Management" GE, but let's do this for the time being).   So, therefore, you just need to create the contents of the wiki page linked to the FI-WARE NGSI RESTful API specification.

  Denes/Lorant, please make sure this action is implemented.

  I hope that you have followed a ToC for the document that aligns to the template for RESTFul API specifications we defined long time ago ... The latest version of that template is described at:
https://forge.fi-ware.eu/plugins/mediawiki/wiki/fi-ware-private/index.php/RESTful_API_specification_template
  Bear in mind that this template has been simplified so a set of common sections has been already published at:
http://forge.fi-ware.eu/plugins/mediawiki/wiki/fiware/index.php/Common_aspects_in_FI-WARE_Open_Restful_API_Specifications

  If for some reason this is not the case (e.g., the template, although inspired in your work in NGSI, came later than your first drafts and you haven't had time to adapt) ... just go ahead and upload the specification following whatever structure you have in your draft.   We can adapt to the official template later (I would suggest during next week since it shouldn't be so hard).

  Best regards,


-- Juanjo

-------------
Product Development and Innovation (PDI) - Telefonica Digital
website: www.tid.es<http://www.tid.es>
email: jhierro at tid.es<mailto:jhierro at tid.es>
twitter: twitter.com/JuanjoHierro

FI-WARE (European Future Internet Core Platform) Chief Architect

You can follow FI-WARE at:
  website:  http://www.fi-ware.eu
  facebook: http://www.facebook.com/pages/FI-WARE/251366491587242
  twitter:  http://twitter.com/FIware
  linkedIn: http://www.linkedin.com/groups/FIWARE-4239932


________________________________

Este mensaje se dirige exclusivamente a su destinatario. Puede consultar nuestra política de envío y recepción de correo electrónico en el enlace situado más abajo.
This message is intended exclusively for its addressee. We only send and receive email on the basis of the terms set out at.
http://www.tid.es/ES/PAGINAS/disclaimer.aspx
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-ngsi/attachments/20120518/cb27081b/attachment.html>