Make Agents Yourself

Ça commence sur cette page : SpeADL Reference.

C'est là : SpeADL Minus Reference.

Quelques remarques et motifs :

Introduction
- dans l'introduction, il n'est pas fait mention de "Speadl Minus" alors que c'est le titre de la page. Il me semble qu'il faut rajouter à la suite de la première phrase, que c'est justement l'objet de cette page que de référencer ces constructions que l'on réunie sous le nom "Speadl Minus".
- la deuxième phrase est trop longue. On ne la comprend pas... Et n'y a t il pas ambiguité entre définition et implantation, Java et non Java?
- Parler de "class definition using SpeADL" me choque un peu... En Speadl, on fait des définitions de composants. En java, éventuellement, on peut parler de définition de classe (de composant générée automatiquement).
- j'enlèverais la phrase "Optionaly ...", elle me semble plus à mettre dans un tutorial
- j'enleverais "(which exactly reflects the definition)" car tu ne montres rien en terme de semantique et d'equivalence...
- la derniere phrase est difficile à lire pour moi. Je ne la comprends pas.

Terminology
Je n'ai pas lu dans un premier temps. Volontairement pour voir si c'était utile...

Namespaces
- je n'aime pas le qualificatif "exact". J'enleverais. En plus, il me semble qu'en java, ce n'est pas qu'une notion d'espace de nommage mais également une indexation physique...
- Details : Je proposerais "In a SpeADL file, there can be many as namespaces as wanted. They can also be nested ones. Hence a namespace does not have to follow the name of the directory it is located in (as it is the case in Java)." (namespaces au pluriel, parentheses devient phrase, in rajouté). J'enleverais la derniere ligne qui fait une référence en avant qu'on ne comprend pas...

Imports
/Details
- est ce que la première phrase ne serait pas plus juste comme ceci : "The namespace of components are also considered when importing component class définitions."
- la ligne "The imports ..." est du domaine du tutorial. Elle est inutile pour quelqu'un qui présente Speadl Minus au tableau à des eleves...
/Example
- déplacer "The syntax is similar to Java:" pour le mettre dans Keyword and Role

Component Definition
- Séparer explications sur ports et parts : "A component definition has provided and required ports. Optionally, a composite component definition declares parts which are component specifications." (peut etre types plutot que spec)
- J'enleverais "A part is structurally similar to a class member in Java." qui est deja défini dans la phrase précédente et devient ambigu avec celle-ci...
- je proposerais plutôt "For each required port of a part, there must be a binding declaring what provided port is providing the required port." pour enfoncer le clou dans la derniere phrase...
/Keywords
- Je changerais "The keyword part is used to declare a part in a composite component definition" pour etre plus précis.
- J'enleverais class de la phrase suivante "It is followed by a name for the part (unique in the component and without capital letter) and a component specification (a component definition name) separated by the character *: *."
- préciser qu'on est dans le cas des composites pour la phrase suivante "A delegation is used to declare for the provided port of a component what other port will provides its implementation."
/Details
- je n'ai pas compris la phrase "All the required of a part must be bound for the component definition to be valid."
/Example
- le premier composant a un port dont le type est "Another....". Pourquoi "Another" et pas "AJavaInterface"?
- au lieu de "MyComplexComponent", "MyCompositeComponent" (quand MAY sera connu pour faire de l'implantation de systèmes complexes artificiels, je ne voudrais pas qu'il y ait ambiguité)
- mettre au moins 2 méthodes dans une des interfaces définies.

Component Implementation
Cette partie n'est clairement pas à mettre dans le manuel de reference de SpeADL Minus. C'est dans le tutorial...

[J'ai du m'arrêter avant la fin de la page. Il y aura une autre mise à jour ;-)]