[Fiware-i2nd] Proposal for specification conventions (I2ND49)

[Marco Castrucci]

Dear Pier,

I uploaded an updated version following your comments.
You can find it here: https://forge.fi-ware.eu/docman/view.php/10/452/I2ND+proposal+for+convention+to+be+used+for+specifications_v0.2.docx

Ciao
Marco
  ----- Original Message ----- 
  From: Marco Castrucci 
  To: Garino Pierangelo ; fiware-i2nd 
  Sent: Tuesday, October 04, 2011 12:55 PM
  Subject: Re: [Fiware-i2nd] Proposal for specification conventions (I2ND49)


  Dear Pier,

  find my comments in line in red.

  Best regards
  Marco
    ----- Original Message ----- 
    From: Garino Pierangelo 
    To: Marco Castrucci ; fiware-i2nd 
    Sent: Tuesday, October 04, 2011 11:20 AM
    Subject: R: Proposal for specification conventions (I2ND49)


    Dear Marco,


    thanks a lot for your contribution. 


    I have some comments/questions/doubts which I try to summarise here:

    -          I'm not familiar with UML (it might sound strange, but I never had to use it in the past), so when you specify it is a modeling language 'mainly' used for design and specs of Object Oriented  software systems, do you mean that its use is not tied to that kind of programming paradigms/languages, but it can be adopted in a broader sense?

    Exactly: it can be used to model any sw (or even hw) system, and do not impose constraints on the programming paradigm/language to be used for the development of the system

    -          For this reason, is the use of class diagrams limiting us or not?

    The concept of class is derived from the object-oriented programming paradigm. Anyway, I don't see problems in developing a system described by means of class diagram, using another programming paradigm. In fact, in our case Class diagrams can be used to describe the interfaces of the system, detailing the functionalities exposed, with its needed input and the provided output. There are no limitations then on the implementation methodology of such interface.

    -          Don't we risk to adopt a top-down modeling approach which is not optimized for FI-WARE, where we already deal with existing portions of the system (i.e. the assets)?

    In case of specification of already available assets, we will have to perform a "reverse engineering" activity, as we will have to create specifications starting from the already available system. 

    -          Concerning point 1 in the suggested use of UML (summary at page 4): in the Agile methodology adopted by FI-WARE, EPICs mean 'work to be done' (see also my yesterday's mail). I wouldn't propose to use them as basis for the creation of Use case diagrams. I would rather start from the 'Product vision', i.e. the High Level Description of our GEs to create such diagrams.

    OK. I'll change the document according and I will upload an updated version soon.



    As a general comment, I proposed the use of UML as it was also proposed by many of WP7 partners when collecting information about tool for design and specification last week. Of course, if there are other proposals for instruments to be used, we can discuss them and find out the best alternative.


    Any further input by other partners to this discussion is of course welcome!


    BR

    Pier





    Da: Marco Castrucci [mailto:castrucci at dis.uniroma1.it] 
    Inviato: martedì 4 ottobre 2011 10:24
    A: fiware-i2nd
    Cc: Garino Pierangelo
    Oggetto: Proposal for specification conventions (I2ND49)


    Dear I2ND partners,


    as decided during our last conf call, we have to make a joint proposal for the conventions to be adopted for FIWARE specifications (action point I2ND49).

    Please find here https://forge.fi-ware.eu/docman/view.php/10/452/I2ND+proposal+for+convention+to+be+used+for+specifications_v0.1.docx our proposal.

    In brief, we propose to use the folowing 4 UML diagrams:

    - Use case diagrams

    - Component diagrams

    - Sequence diagrams

    - Class diagrams

    In addition, we also propose the use of StarUML as a free tool to depict UML diagrams.


    Comments and feedbacks are welcome so that we can finalize our proposal by next Friday (7 October) and then Pier can discuss it at project level.


    Best regards

    Marco


    -----------------------------------------------
    Dr. Ing. Castrucci Marco

    University of Rome "Sapienza"
    V. Ariosto 25, 00185 Rome, Italy
    Tel (+39) 06 77274039 (037)
    Fax (+39) 06 77274033
    Mob (+39) 348 7709997
    email: castrucci at dis.uniroma1.it

          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. 

          Rispetta l'ambiente. Non stampare questa mail se non è necessario. 
         



----------------------------------------------------------------------------






------------------------------------------------------------------------------


  _______________________________________________
  Fiware-i2nd mailing list
  Fiware-i2nd at lists.fi-ware.eu
  http://lists.fi-ware.eu/listinfo/fiware-i2nd
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/old-fiware-i2nd/attachments/20111006/0edd10fc/attachment.html>