[Fiware-i2nd] Update of I2ND Open Specs/API wiki pages

[Garino Pierangelo]

Dear GE Owners,

A fundamental (and hopefully) final task to accomplish, to be able to place a big stamp 'Done' on the whole set of r2.2 I2ND deliverables: update of Open Specifications and API pages of our GEs according to the peer review done by the reviewers of another chapter (Security).

As you know this is a task we should have been completed about one week ago, but unfortunately we have received the reviewed documents only today (two days ago for NetIC), and one is still missing! Proj Coords are aware of this situation, and Security WPL was already requested to speed up the process completion (assigned however to another person).

You can find the reviewed documents, which include the comments you need to manage, either in the open specs peer review cockpit at https://docs.google.com/spreadsheet/ccc?key=0AmxBgS-lWT4vdHYxYTVOZ3FrNEprZXRBZk80TGRLMGc#gid=0 , or by using the direct link below to the document of your interest:

CDI: https://forge.fi-ware.eu/docman/view.php/27/2327/D712_WP7_v3_generated%2BCDI%2BCE-TRTreview.docx  (see NOTE below)
CP/CE: https://forge.fi-ware.eu/docman/view.php/27/2327/D712_WP7_v3_generated%2BCDI%2BCE-TRTreview.docx  (see NOTE below)
NetIC: Already updated if I'm correct  https://forge.fi-ware.eu/docman/view.php/27/2311/D712_WP7_v3_generated-WS.docx
S3C. still missing...

NOTE: The document containing the CDI and CE review is the same! So please take care of your GE comments only!


HOW TO PROCEED


1)      Where updates have to be done
You need to update the wiki pages directly in the public wiki (I moved already the API pages from the I2ND to the public wiki to create the overall document). Please distribute among the GE API providers the update workload. There are few cases where also the architecture sections have been commented, please check if the revisions are acceptable (for CP it seems that the update since past revisions was not done, was it?), otherwise report to me.


2)      How to manage conflicting comments
I suggest you respond to the reviewer comment by adding another comment in the MSWord document, while accepting the other revisions you take into account. Then we'll send the documents back to the reviewers to let them understand why a specific comment was not taken into account.


3)      API change history
Each GE has used a different way to represent the API change history section. Please use all the following table format:

Revision Date

Changes Summary

Apr 2, 2012


 *   Initial version blabla (author)


Which turns into this wiki code:

{| style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #000"
|-
! style="border-style: solid; border-width: 1px"| Revision Date
! style="border-style: solid; border-width: 1px"| Changes Summary
|-
| style="border-style: solid; border-width: 1px"| Apr 2, 2012
| style="border-style: solid; border-width: 1px"|
* Initial version
|-
|}


4)      Schedule

I kindly ask you to complete this update by Monday 11:00.


Thanks and BR
Pier



------------------------------------------------------------------
Telecom Italia
Pierangelo Garino
Innovation & Industry Relations - Research & Prototyping
Via G. Reiss Romoli 274, I-10148 TORINO
Tel: +39 011 228 7142

Questo messaggio e i suoi allegati sono indirizzati esclusivamente alle persone indicate. La diffusione, copia o qualsiasi altra azione derivante dalla conoscenza di queste informazioni sono rigorosamente vietate. Qualora abbiate ricevuto questo documento per errore siete cortesemente pregati di darne immediata comunicazione al mittente e di provvedere alla sua distruzione, Grazie.

This e-mail and any attachments is confidential and may contain privileged information intended for the addressee(s) only. Dissemination, copying, printing or use by anybody else is unauthorised. If you are not the intended recipient, please delete this message and any attachments and advise the sender by return e-mail, Thanks.

[cid:00000000000000000000000000000003 at TI.Disclaimer]Rispetta l'ambiente. Non stampare questa mail se non ? necessario.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/old-fiware-i2nd/attachments/20130517/b6d9a5bf/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: logo Ambiente_foglia2.jpg
Type: image/jpeg
Size: 677 bytes
Desc: logo Ambiente_foglia2.jpg
URL: <https://lists.fiware.org/private/old-fiware-i2nd/attachments/20130517/b6d9a5bf/attachment.jpg>