Docstoc

Documentation

Document Sample
Documentation Powered By Docstoc
					Documentation installation.

La première étape de toute confrontation avec un software, que ce soit dans un but d’utilisation pure
ou de développement est l’installation de l’application.

Dans cette perspective on s’attend à trouver certaines informations que l’on a référencées dans le
tableau ci-dessous. Ils ont une importance relative caractérisée par le poids donné. Voyons s’ils sont
présents ou non.

Document           Présent Oui Non Ambigüe Poids                 Commentaire
Y a-t-il des               V               1                     Basé sue des licences générales GNU
informations
sur les licences
utilisées ?
Y-a-t-il un                              A           4           Présence d’un descriptif de
guide                                                            l’installation sur le site
d’installation ?                                                 http://attempto.ifi.uzh.ch/acewiki/
                                                                 + un fichier « INSTALL » mais très
                                                                 imprécis.
                                                                 Insuffisant pour assurer une
                                                                 installation rapide et complète.
Y-a-t-il la                  V                       1
présence d’un
contact en cas
de besoin
Y-a-t-il une                       X
F.A.Q. pour
l’installation ?
Formalisation
de la
documentation
Les                                X                 1           L’information est présente aussi bien
informations                                                     sur des sites internet que dans les
sont-elles                                                       dossiers sources.
centralisées ?
Les                                X                 1
informations
sont-elles
présentées de
manière
homogène ?
Total                                                2/8
        Documentation utilisateur.

Afin de pouvoir utiliser de manière convenable un logiciel, les documents de la liste ci-dessous
doivent être présents. Ils ont la encore une importance relative caractérisée par le poids.

Document            Présent   Oui   Non Ambigüe Poids            Commentaire
Y-a-t-il un guide                       A       6*               Présence d’une vidéo expliquant
utilisateur ?                                                    succinctement l’utilisation du
                                                                 logiciel, mais manque de précision.
Y-a-t-il un                         X                 1
manuel
d’exploitation ?
Y-a-t-il un                         X                 1
manuel de
maintenance ?
Y-a-t-il une                        X                 1
F.A.Q. pour
l’utilisateur ?

Formalisation
de la
documentation
Les                       V                           1
informations
sont-elles
centralisées ?
Les                       V                           1
informations
sont-elles
présentées de
manière
homogène ?
Total                                                 4/13
     Poids accordé : 2/6

Présent en plus :

Document        Commentaire
Wiki de         Présent sur le site internet :
démonstration   http://attempto.ifi.uzh.ch/acewiki/
                Permet à l’utilisateur une première prise en main.
Poster/brochure Présent sur le site internet :
                http://attempto.ifi.uzh.ch/acewiki/
                Présente certaines fonctionnalités de l’application
Documentation développeur.

         Afin de faciliter la reprise du software (continuation du développement, développement
annexe…) et s agissant d’un software sous licence GNU, on s’attend a avoir accès à divers documents
facilitant le travail du développeur extérieur.

Document          Présent    Oui   Non     Ambigüe     Poids    Commentaire
Y-a-t-il des                       X                   2
diagrammes
UML de
l’application ?
Y-a-t-il de la               V                         4        Présent sous forme de java doc.
documentation
pour chaque
classes et ses
fonctions ?
Y-a-t-il des                 V                         1        Utilisation du langage Ace,
informations                                                    Prolog(pour les prédicats), Ajax
sur les                                                         pour l’interface.
technologies
utilisées ?
Est-il possible              V                         2        https://bugs.launchpad.net/acewi
de rapporter un                                                 ki
bug et
d’accéder au
listing des
bugs ?
A-t-on accès                 V                         4        Sur le site :
aux sources ?                                                   http://attempto.ifi.uzh.ch/acewiki/
A-t-on accès                 V                         2        Sur le site :
aux différentes                                                 http://attempto.ifi.uzh.ch/site/do
versions du                                                     wnloads/
logiciel ?
A-t-on accès à                     X                   1
une F.A.Q. pour
le
développeur ?
Formalisation
de la
documentation
Les                          V                         1        Les plus importantes sont
informations                                                    regroupées dans les dossiers
sont-elles                                                      d’installation :
centralisées ?
Les                          V                         1
informations
sont-elles
présentées de
manière
homogène ?
Total                                                  15/18
En plus :

“Controlled English for        Reprend les outils incluent dans ACEWiki et les concepts utilisés.
Knowledge Representation”      Définit aussi l’utilité de l’outil ACEWiki.
(Thèse concernant l’ACEwiki,   Explication des choix techniques et ergonomique.
par son développeur            Présence de ressource pour le projet.
principal)
Controlled English for         Définit la position du langage ACE dans le web sémantique. Ainsi que
Reasoning on the Semantic      ses concepts fondateurs.
Web                            Présentation du moteur d’analyse Attempto.
                               Définit le positionnement d’ACEWiki dans le web sémantique.
How Controlled English Can     Utilité du « controlled English » dans les web sémantiques. ACE
Improve Semantic Wikis         utilise ce procédé. Présentation don t ce procédé est utilisé par
                               ACEWiki via le langage ACE.
                               Présentation de test d’utilisabilité de ACEWiki
Combining Semantic Wikis       Présentation de l’utilisation du contrôle du langage naturel par
and Controlled Natural         ACEWiki. Ceci via l’ « ACEEditor » et de l’interface de présentation
Language                       des prédicats.
Writing Support for            Présentation du ACEEditor et explication des choix effectués pour
Controlled Natural             cette interface.
Languages                      Présentation de la grammaire ACEWiki (différentes classes
                               existantes…)
Attempto Controlled English    Présentation du langage ACE, de sa grammaire (règles de
for Knowledge                  construction et d’interprétation) ; de son vocabulaire (Certains mots
Representation                 représentent une fonction, d’autre sont des mots « standards ») ; et
                               de sa construction de phrase.
                               Explication du principe utilisé pour les requêtes, pour la gestion des
                               ambiguïtés.
                               Présentation également des outils utilisant le langage ACE (dont
                               ACEWiki)
ACEwiki: Collaborative         Montre comment ACEWiki gère les ontologies via le langage naturel
Ontology Management in         contrôlé et les avantages que cela apporte.
Controlled Natural Language
ACEwiki: A Natural and       Présentation d’ACEWiki et de son ergonomie (avec notamment la
Expressive Semantic Wiki     présentation de tests d’utilisabilité)
Ces informations supplémentaires apportent beaucoup pour la personne souhaitant

				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:19
posted:3/30/2012
language:
pages:4