Documenter son code en RDF

Posté en august 2008


Entre autres suggestions, je vais réfléchir à ça mais c'est vrai qu'il pourrait être intéressant d'avoir des convention style Turtle qui pourraient ensuite être exploitées par les IDE (tout en restant lisible). Ou lorsque le Web Sémantique sort du web.


5 Commentaires

Déjà que j'ai de la peine avec les doc de type javadoc, reste éloigné de la version XML concoctée par Microsoft alors l'idée d'utiliser RDF directement me rend un peu sceptique.

Il pourrait être en revanche intéressant de créer une base de triples à partir de documentation existante, ReST-like ou JavaDoc-like. Ça signifierait une véritable recherche multi-facettes et plus le traditionnel et si ennuyeux jeu de cadres : modules, classes/fonctions, détail.

De mon point de vue, une solution qui nécessite un IDE pour s'en servir n'est pas une solution vers laquelle je me tournerai.

1 | Yoan, le 24 August 2008 à 10h

"Il pourrait être en revanche intéressant de créer une base de triples à partir de documentation existante, ReST-like"

C'est quoi une documentation ReST-like ?

2 | Damien B, le 24 August 2008 à 14h

@Yoan : je ne souhaite justement pas qu'une IDE soit nécessaire (d'où le "tout en restant lisible"), l'IDE permettrait juste d'exploiter à fond les possibilités offertes par RDF, style pouvoir passer une requête SPARQL sur tous les commentaires d'un code : donne moi toutes les fonctions qui ont un email en entrée et qui me retournent une liste de personnes, etc.

J'évoquais turtle car c'est l'une des syntaxes les plus simples pour écrire du RDF à mon avis, il y a ntriples aussi : http://www.w3.org/TR/rdf-testcases/#ntriples il y a un joli graphe qui résume ça sur la page de notation 3 : http://www.w3.org/DesignIssues/Notation3

@Damien B.: il s'agit de http://docutils.sourceforge.net/rst.html

3 | David, biologeek, le 25 August 2008 à 09h

Ha, reST, pas ReST. Courage, encore quelques heures de réflexion, et on va nous ressortir CWEB.

4 | Damien B, le 25 August 2008 à 13h

Ajouter un commentaire


Billets ★ choisis

★ RDF, l'ADN de notre identité numérique ?

Logo associé au billet intitulé RDF, l'ADN de notre identité numérique ?

Il était 6 heures du matin, dans un bateau me menant en Corse (après un voyage épique, ne prenez pas la SNCM !) et j'étais en train de lire la première boucle d'Hominescence décrite par Michel Serres, lorsque j ...

★ Le point sur RDF et RDFa

Logo associé au billet intitulé Le point sur RDF et RDFa

À lire les comptes rendus de Samuel Martin et Nicolas Le Gall, je me suis vraiment mal exprimé lors de ce dernier WaSP Café consacré au Web Sémantique (j'ai actualisé la liste des ressources au passage). Je m'en ...

★ Ergonomie d'un blog : analyse des réponses

Je comptais insérer la synthèse dans le billet sur l'ergonomie des blogs mais vous avez été tellement nombreux à répondre que ça méritait un billet à part entière. Les réponses sont désormais en ligne donc le sondage est clos ...


© 2004-2012 David Larlet - Licence (presque) libre - Site enfin propulsé par Django et hébergé par Typhon.