larlet-fr-david/david/biologeek/archives/20080823-documenter-son-code-en-rdf/comments.html

<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Yoan</span> le <span class="comment-date" property="schema:commentTime">24/08/2008</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Déjà que j&#39;ai de la peine avec les doc de type javadoc, reste éloigné de la version XML concoctée par Microsoft  alors l&#39;idée d&#39;utiliser RDF directement me rend un peu sceptique.</p>

<p>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.</p>

<p>De mon point de vue, une solution qui nécessite un IDE pour s&#39;en servir n&#39;est pas une solution vers laquelle je me tournerai.</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Damien B</span> le <span class="comment-date" property="schema:commentTime">24/08/2008</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>&quot;Il pourrait être en revanche intéressant de créer une base de triples à partir de documentation existante, ReST-like&quot;</p>

<p>C&#39;est quoi une documentation ReST-like ?</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">25/08/2008</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>@Yoan : je ne souhaite justement pas qu&#39;une IDE soit nécessaire (d&#39;où le &quot;tout en restant lisible&quot;), l&#39;IDE permettrait juste d&#39;exploiter à fond les possibilités offertes par RDF, style pouvoir passer une requête SPARQL sur tous les commentaires d&#39;un code : donne moi toutes les fonctions qui ont un email en entrée et qui me retournent une liste de personnes, etc.</p>

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

<p>@Damien B.: il s&#39;agit de <a href="http://docutils.sourceforge.net/rst.html">http://docutils.sourceforge.net/rst.html</a></p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Damien B</span> le <span class="comment-date" property="schema:commentTime">25/08/2008</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Ha, reST, pas ReST. Courage, encore quelques heures de réflexion, et on va nous ressortir CWEB.</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">François Parmentier</span> le <span class="comment-date" property="schema:commentTime">26/08/2008</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Ça me rappelle l&#39;indexation de code source en RDF que nous avions faite sur un ancien projet:</p>

<p><a href="http://dilib.inist.fr/bin/dilib/v04Public/IndexSite/doc.ref.cgi?/dps/public/dilib/v0.4/Targets/Public/WWW/IndexSite/Server/FR.resource.FD.wsh+000583">http://dilib.inist.fr/bin/dilib/v04Public/IndexSite/doc.ref.cgi?/dps/public/dilib/v0.4/Targets/Public/WWW/IndexSite/Server/FR.resource.FD.wsh+000583</a></p>

<p><a href="http://dilib.inist.fr/bin/dilib/v04Public/IndexSite/desc.cgi?/dps/public/dilib/v0.4/Targets/Public/WWW/IndexSite/Server/FR.resource.FD.wsh+Buffer%2C%2520module">http://dilib.inist.fr/bin/dilib/v04Public/IndexSite/desc.cgi?/dps/public/dilib/v0.4/Targets/Public/WWW/IndexSite/Server/FR.resource.FD.wsh+Buffer,%20module</a></p>

<p>Le RDF n&#39;était pas parfait, mais on a dû faire pendant le millénaire dernier ;)</p>
    </div>
</div>