[Fiware-wpa] Naming convention for enablers with more than one implementation

[Miguel Carrillo]

Dear Torsten, dear Pascal,

As regards those deliverables not following the naming convention now let us follow these rules:

  *   Enablers with a single implementation. There is no reason to use an alternative name. The User & Prog. Manual, The Install. and Admin guide etc. must follow the convention expressed in the guidelines.

  *   Enablers with more than one implementation: I understand that this is undefined as it is now. Let us proceed this way:
     *   Under the section "Materializing ... " in the wiki we will have entries with the usual names:
        *   <GE Name> - Unit Testing Plan
        *   <GE Name> - Installation and Administration Guide
        *   <GE Name> - User and Programmers Guide
        *   Example:

[cid:part1.00010008.00080500 at tid.es]

     *   Then each one of these takes to a page with a list of all the manuals, one line per manual, and you can have something like this per line/manual.
        *   <GE Name> -  <Implementation Name> <Manual Name>
        *   Example: clicking on  "Composition Editor -  Unit Testing Plan" will take us to a page where the first line is:
           *   Composition Editor - Light Semantic Composition Unit Testing Plan
           *   there will be others in the future, one per implementation of the GE
           *   each one of these lines will link to a dedicated page with the manual for that concrete implementation

Hope this is clear and helps you to organize thing. Note that this is not added work, you do not need to do it in the private wiki if you do not want to, it can be done in 5 minutes as you take the contents to the public wiki.

Regards,

Miguel




________________________________

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-wpa/attachments/20120717/a7445777/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ecjdcije.png
Type: image/png
Size: 4332 bytes
Desc: not available
URL: <https://lists.fiware.org/private/fiware-wpa/attachments/20120717/a7445777/attachment.png>