davidbgk
/
larlet-fr-david

<!doctype html>
<html lang=fr>
<head>
  <!-- Always define the charset before the title -->
  <meta charset=utf-8>
  <title>Documenter son code en RDF — Biologeek — David Larlet</title>
  <!-- Define a viewport to mobile devices to use - telling the browser to assume that the page is as wide as the device (width=device-width) and setting the initial page zoom level to be 1 (initial-scale=1.0) -->
  <meta name="viewport" content="width=device-width, initial-scale=1"/>
  <!-- Fake favicon, to avoid extra request to the server -->
  <link rel="icon" href="data:;base64,iVBORw0KGgo=">
  <link type="application/atom+xml" rel="alternate" title="Feed" href="/david/log/" />
  <link rel="manifest" href="/manifest.json">
  
  <link rel="stylesheet" href="/static/david/css/larlet-david-_J6Rv.css" data-instant-track />
  
  <noscript>
    <style type="text/css">
      /* Otherwise fonts are loaded by JS for faster initial rendering. See scripts at the bottom. */
      body {
        font-family: 'EquityTextB', serif;
      }
      h1, h2, h3, h4, h5, h6, time, nav a, nav a:link, nav a:visited {
        font-family: 'EquityCapsB', sans-serif;
        font-variant: normal;
      }
    </style>
  </noscript>
  
  <!-- Canonical URL for SEO purposes -->
  <link rel="canonical" href="https://larlet.fr/david/biologeek/archives/20080823-documenter-son-code-en-rdf">

</head>
<body>
  <div>
    
    <header>
      <nav>
        <p>
          <small>
            Je suis <a href="/david/" title="Profil public">David Larlet</a>, <a href="/david/pro/" title="Activité professionnelle">artisan</a> du web qui vous <a href="/david/pro/accompagnement/" title="Activité d’accompagnement">accompagne</a><span class="more-infos"> dans l’acquisition de savoirs pour concevoir des <a href="/david/pro/produits-essentiels/" title="Qu’est-ce qu’un produit essentiel ?">produits essentiels</a></span>. <span class="more-more-infos">Discutons ensemble d’une <a href="/david/pro/devis/" title="En savoir plus">non-demande de devis</a>.</span> Je partage ici mes <a href="/david/blog/" title="Expériences bienveillantes">réflexions</a> et <a href="/david/correspondances/2017/" title="Lettres hebdomadaires">correspondances</a>.
          </small>
        </p>
      </nav>
    </header>
    
    
  <section>
    <h1 property="schema:name">Documenter son code en RDF</h1>
    <article typeof="schema:BlogPosting">
      <div property="schema:articleBody">
        
        <p>Entre <a href="http://aabs.wordpress.com/2008/08/22/semantic-development-environments/">autres suggestions</a>, je vais réfléchir à ça mais c'est vrai qu'il pourrait être intéressant d'avoir des convention <a href="http://www.dajobe.org/2004/01/turtle/">style Turtle</a> qui pourraient ensuite être exploitées par les IDE (tout en restant lisible). Ou lorsque le Web Sémantique sort du web.</p>
      </div>
    </article>
    <footer>
      <h6 property="schema:datePublished">— 23/08/2008</h6>
    </footer>
  </section>
  <section>
    <div>
      <h3>Articles peut-être en rapport</h3>
      <ul>
        <li><a href="/david/biologeek/archives/20080821-meilleur-client-ssh-sur-iphone/" title="Accès à Meilleur client SSH sur iPhone ?">Meilleur client SSH sur iPhone ?</a></li>
        <li><a href="/david/biologeek/archives/20080820-conseils-pour-une-bonne-relation-client-freelance/" title="Accès à Conseils pour une bonne relation client/freelance">Conseils pour une bonne relation client/freelance</a></li>
        <li><a href="/david/biologeek/archives/20080812-revue-de-web/" title="Accès à Revue de web">Revue de web</a></li>
      </ul>
    </div>
  </section>
  <section>
    <div id="comments">
      <h3>Commentaires</h3>
      
<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>

    </div>
  </section>

    
    <footer>
      <nav>
        <p>
          <small>
            Je réponds quasiment toujours aux <a href="m&#x61;ilto:d&#x61;vid%40l&#x61;rlet&#46;fr" title="Envoyer un email">emails</a> (<a href="/david/signature/" title="Ma signature actuelle avec possibilité de chiffrement">signés</a>) et vous pouvez me rencontrer à Montréal. <span class="more-infos">N’hésitez pas à <a href="/david/log/" title="Être tenu informé des mises à jour">vous abonner</a> pour être tenu informé des publications récentes.</span>
          </small>
        </p>
      </nav>
    </footer>
    
  </div>
  
  <script src="/static/david/js/larlet-david-3ee43f.js" data-no-instant></script>
  
  <script data-no-instant>InstantClick.init()</script>
  
</body>
</html>