[Fiware-wpl] IMPORTANT REMINDER: Re-structuring of the public wiki contents to be finished by EOB TODAY

[Juanjo Hierro]

Hi all,

  This is a reminder that you have until EOB TODAY to re-structure the contents of the wiki that relate to GEs in your chapter.   The goal is to create a wiki page per GE that comprise the complete specification of the GE.   Those wiki pages will help to produce the final FI-WARE GE Open Specifications deliverables to be resubmitted.

  You can easily produce the wiki page associated to a given GE by following the template with instructions provided at:
https://forge.fi-ware.eu/plugins/mediawiki/wiki/fi-ware-private/index.php/Open_specification_resubmission_template

  Probably, a first step before generating this page for the GE <GE-name> in Chapter <Chapter-name> is to modify the Architecture Description wiki page linked to that GE referred as FIWARE.ArchitectureDescription.<Chapter-name>.<GE-name>.   As indicated in the template+instructions above, you should introduce the following changes in the Architecture Description wiki page:


  1.  You should include a Copyright section which lists the copyright holders
  2.  You should include a Legal Notice section which incudes a reference to the Legal Notice that applies to your GE specifications
  3.  You should include a description of the intended use/role of the GE in the Introduction section of the FI-WARE Architecture Description wiki page itself. You can reuse the information already provided in the FI-WARE_Product_Vision in section "Target usage" of your chapter/GE, but please duplicate the current information.
  4.  Create a new page on the wiki named as FIWARE.OpenSpecification.Details.<chapter-name>.<ge-name>, where the contents of the "Open Specifications" section in the Architecture Description wiki page will be copied.
  5.  Drop the section "Open Specifications" that was there within the wiki page associated to the Architecture Description (you have copied its contents now in the new FIWARE.OpenSpecification.Details.<chapter-name>.<ge-name> page)
  6.  On the RESTful open API specification of your GE the Intended Audience needs to be revised it should be changed to address reimplementers as potential target users:

"This specification is intended for both software developers and <any other potential user if applies>. For the former, this document provides a full specification of how to
"This specification is intended for both software developers and reimplementers of this API. For the former, this document provides a full specification of how to <explain-1>.

  Making the above changes per Achitecture Description of a given GE and then creating the corresponding wiki page for the complete Open Specifications is a task that may not take more than a few minutes per GE.   Indeed, it may not be a bad idea that each chapter leader takes care of the whole chapter revision himself or with the help of a few people.   It's up to you.

  I have already produced the wikipages for the Glossaries of all chapters and fixed their inline inclusion for the current wiki pages of the FI-WARE Product Vision.   That will save you some time.   It took me a while (not more than half an hour) but I volunteered to speed up the overall process.

  If you have any doubt, don't hesitate to ask Thorsten (in copy of this email) or me

  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-wpl/attachments/20121009/ec61042d/attachment.html>