davidbgk
/
larlet-fr-david

<!doctype html><!-- This is a valid HTML5 document. -->
<!-- Screen readers, SEO, extensions and so on. -->
<html lang=fr>
<!-- Has to be within the first 1024 bytes, hence before the <title>
  See: https://www.w3.org/TR/2012/CR-html5-20121217/document-metadata.html#charset -->
<meta charset=utf-8>
<!-- Why no `X-UA-Compatible` meta: https://stackoverflow.com/a/6771584 -->
<!-- The viewport meta is quite crowded and we are responsible for that.
  See: https://codepen.io/tigt/post/meta-viewport-for-2015 -->
<meta name=viewport content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no">
<!-- Required to make a valid HTML5 document. -->
<title>Collaboration technique — David Larlet</title>
<!-- Generated from https://realfavicongenerator.net/ such a mess. -->
<link rel="apple-touch-icon" sizes="180x180" href="/static/david/icons/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/static/david/icons/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/static/david/icons/favicon-16x16.png">
<link rel="manifest" href="/manifest.json">
<link rel="mask-icon" href="/static/david/icons/safari-pinned-tab.svg" color="#5bbad5">
<link rel="shortcut icon" href="/static/david/icons/favicon.ico">
<meta name="apple-mobile-web-app-title" content="David Larlet">
<meta name="application-name" content="David Larlet">
<meta name="msapplication-TileColor" content="#da532c">
<meta name="msapplication-config" content="/static/david/icons/browserconfig.xml">
<meta name="theme-color" content="#f0f0ea">
<!-- That good ol' feed, subscribe :p. -->
<link rel=alternate type="application/atom+xml" title=Feed href="/david/log/">

  <!-- Canonical URL for SEO purposes -->
  <link rel="canonical" href="https://larlet.fr/david/blog/2015/collaboration-technique/">
  <!-- SEO/Semantic metadata -->
  <meta name="description" content="Retour sur une formation/accompagnement chez Natural-Solutions." />
  <meta name="twitter:description" property="og:description" itemprop="description" content="Retour sur une formation/accompagnement chez Natural-Solutions." />
  <meta name="twitter:title" property="og:title" itemprop="name" content="Collaboration technique" />
  <meta name="twitter:card" content="summary" />
  <meta name="twitter:creator" content="@davidbgk" />
  <meta name="twitter:url" property="og:url" content="https://larlet.fr/david/blog/2015/collaboration-technique/" />
  <meta property="og:type" content="article" />
  <meta property="og:site_name" content="David Larlet (@davidbgk)" />

  <meta name="twitter:image" property="og:image" itemprop="image" content="https://larlet.fr/static/david/blog/2015/collaboration-technique.jpg" />


<style>
/* http://meyerweb.com/eric/tools/css/reset/ */
html, body, div, span,
h1, h2, h3, h4, h5, h6, p, blockquote, pre,
a, abbr, address, big, cite, code,
del, dfn, em, img, ins,
small, strike, strong, tt, var,
dl, dt, dd, ol, ul, li,
fieldset, form, label, legend,
table, caption, tbody, tfoot, thead, tr, th, td,
article, aside, canvas, details, embed,
figure, figcaption, footer, header, hgroup,
menu, nav, output, ruby, section, summary,
time, mark, audio, video {
  margin: 0;
  padding: 0;
  border: 0;
  font-size: 100%;
  font: inherit;
  vertical-align: baseline;
}
/* HTML5 display-role reset for older browsers */
article, aside, details, figcaption, figure,
footer, header, hgroup, menu, nav, section { display: block; }
body { line-height: 1; }
blockquote, q { quotes: none; }
blockquote:before, blockquote:after,
q:before, q:after {
  content: '';
  content: none;
}
table {
  border-collapse: collapse;
  border-spacing: 0;
}

/* http://practicaltypography.com/equity.html */
/* https://calendar.perfplanet.com/2016/no-font-face-bulletproof-syntax/ */
/* https://www.filamentgroup.com/lab/js-web-fonts.html */
@font-face {
  font-family: 'EquityTextB';
  src: url('/static/david/css/fonts/Equity-Text-B-Regular-webfont.woff2') format('woff2'),
       url('/static/david/css/fonts/Equity-Text-B-Regular-webfont.woff') format('woff');
  font-weight: 300;
  font-style: normal;
  font-display: swap;
}
@font-face {
  font-family: 'EquityTextB';
  src: url('/static/david/css/fonts/Equity-Text-B-Italic-webfont.woff2') format('woff2'),
       url('/static/david/css/fonts/Equity-Text-B-Italic-webfont.woff') format('woff');
  font-weight: 300;
  font-style: italic;
  font-display: swap;
}
@font-face {
  font-family: 'EquityTextB';
  src: url('/static/david/css/fonts/Equity-Text-B-Bold-webfont.woff2') format('woff2'),
       url('/static/david/css/fonts/Equity-Text-B-Bold-webfont.woff') format('woff');
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: 'ConcourseT3';
  src: url('/static/david/css/fonts/concourse_t3_regular-webfont-20190806.woff2') format('woff2'),
       url('/static/david/css/fonts/concourse_t3_regular-webfont-20190806.woff') format('woff');
  font-weight: 300;
  font-style: normal;
  font-display: swap;
}


/* http://practice.typekit.com/lesson/caring-about-opentype-features/ */
body {
  /* http://www.cssfontstack.com/ Palatino 99% Win 86% Mac */
  font-family: "EquityTextB", Palatino, serif;
  background-color: #f0f0ea;
  color: #07486c;
  font-kerning: normal;
  -moz-osx-font-smoothing: grayscale;
  -webkit-font-smoothing: subpixel-antialiased;
  text-rendering: optimizeLegibility;
  font-variant-ligatures: common-ligatures contextual;
  font-feature-settings: "kern", "liga", "clig", "calt";
}
pre, code, kbd, samp, var, tt {
  font-family: 'TriplicateT4c', monospace;
}
em {
  font-style: italic;
  color: #323a45;
}
strong {
  font-weight: bold;
  color: black;
}
nav {
  background-color: #323a45;
  color: #f0f0ea;
  display: flex;
  justify-content: space-around;
  padding: 1rem .5rem;
}
  nav:last-child {
    border-bottom: 1vh solid #2d7474;
  }
  nav a {
    color: #f0f0ea;
  }
  nav abbr {
    border-bottom: 1px dotted white;
  }

h1 {
  border-top: 1vh solid #2d7474;
  border-bottom: .2vh dotted #2d7474;
  background-color: #e3e1e1;
  color: #323a45;
  text-align: center;
  padding: 5rem 0 4rem 0;
  width: 100%;
  font-family: 'ConcourseT3';
  display: flex;
  flex-direction: column;
}
  h1.single {
    padding-bottom: 10rem;
  }
  h1 span {
    position: absolute;
    top: 1vh;
    left: 20%;
    line-height: 0;
  }
    h1 span a {
      line-height: 1.7;
      padding: 1rem 1.2rem .6rem 1.2rem;
      border-radius: 0 0 6% 6%;
      background: #2d7474;
      font-size: 1.3rem;
      color: white;
      text-decoration: none;
    }
h2 {
  margin: 4rem 0 1rem;
  border-top: .2vh solid #2d7474;
  padding-top: 1vh;
}
h3 {
  text-align: center;
  margin: 3rem 0 .75em;
}
hr {
  height: .4rem;
  width: .4rem;
  border-radius: .4rem;
  background: #07486c;
  margin: 2.5rem auto;
}
time {
  display: bloc;
  margin-left: 0 !important;
}
ul, ol {
  margin: 2rem;
}
ul {
  list-style-type: square;
}
a {
  text-decoration-skip-ink: auto;
  text-decoration-thickness: 0.05em;
  text-underline-offset: 0.09em;
}
article {
  max-width: 50rem;
  display: flex;
  flex-direction: column;
  margin: 2rem auto;
}
  article.single {
    border-top: .2vh dotted #2d7474;
    margin: -6rem auto 1rem auto;
    background: #f0f0ea;
    padding: 2rem;
  }
  article p:last-child {
    margin-bottom: 1rem;
  }
p {
  padding: 0 .5rem;
  margin-left: 3rem;
}
  p + p,
  figure + p {
    margin-top: 2rem;
  }

blockquote {
  background-color: #e3e1e1;
  border-left: .5vw solid #2d7474;
  display: flex;
  flex-direction: column;
  align-items: center;
  padding: 1rem;
  margin: 1.5rem;
}
  blockquote cite {
    font-style: italic;
  }
  blockquote p {
    margin-left: 0;
  }

figure {
  border-top: .2vh solid #2d7474;
  background-color: #e3e1e1;
  text-align: center;
  padding: 1.5rem 0;
  margin: 1rem 0 0;
  font-size: 1.5rem;
  width: 100%;
}
  figure img {
    max-width: 250px;
    max-height: 250px;
    border: .5vw solid #323a45;
    padding: 1px;
  }
figcaption {
  padding: 1rem;
  line-height: 1.4;
}
aside {
  display: flex;
  flex-direction: column;
  background-color: #e3e1e1;
  padding: 1rem 0;
  border-bottom: .2vh solid #07486c;
}
  aside p {
    max-width: 50rem;
    margin: 0 auto;
  }

/* https://fvsch.com/code/css-locks/ */
p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
  font-size: 1rem;
  line-height: calc( 1.5em + 0.2 * 1rem );
}
h1 {
  font-size: 1.9rem;
  line-height: calc( 1.2em + 0.2 * 1rem );
}
h2 {
  font-size: 1.6rem;
  line-height: calc( 1.3em + 0.2 * 1rem );
}
h3 {
  font-size: 1.35rem;
  line-height: calc( 1.4em + 0.2 * 1rem );
}
@media (min-width: 20em) {
  /* The (100vw - 20rem) / (50 - 20) part
     resolves to 0-1rem, depending on the
     viewport width (between 20em and 50em). */
  p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
    font-size: calc( 1rem + .6 * (100vw - 20rem) / (50 - 20) );
    line-height: calc( 1.5em + 0.2 * (100vw - 50rem) / (20 - 50) );
    margin-left: 0;
  }
  h1 {
    font-size: calc( 1.9rem + 1.5 * (100vw - 20rem) / (50 - 20) );
    line-height: calc( 1.2em + 0.2 * (100vw - 50rem) / (20 - 50) );
  }
  h2 {
    font-size: calc( 1.5rem + 1.5 * (100vw - 20rem) / (50 - 20) );
    line-height: calc( 1.3em + 0.2 * (100vw - 50rem) / (20 - 50) );
  }
  h3 {
    font-size: calc( 1.35rem + 1.5 * (100vw - 20rem) / (50 - 20) );
    line-height: calc( 1.4em + 0.2 * (100vw - 50rem) / (20 - 50) );
  }
}
@media (min-width: 50em) {
  /* The right part of the addition *must* be a
     rem value. In this example we *could* change
     the whole declaration to font-size:2.5rem,
     but if our baseline value was not expressed
     in rem we would have to use calc. */
  p, li, pre, code, kbd, samp, var, tt, time, details, figcaption {
    font-size: calc( 1rem + .6 * 1rem );
    line-height: 1.5em;
  }
  p, li, pre, details {
    margin-left: 3rem;
  }
  h1 {
    font-size: calc( 1.9rem + 1.5 * 1rem );
    line-height: 1.2em;
  }
  h2 {
    font-size: calc( 1.5rem + 1.5 * 1rem );
    line-height: 1.3em;
  }
  h3 {
    font-size: calc( 1.35rem + 1.5 * 1rem );
    line-height: 1.4em;
  }
  figure img {
    max-width: 500px;
    max-height: 500px;
  }
}

figure.unsquared {
  margin-bottom: 1.5rem;
}
  figure.unsquared img {
    height: inherit;
  }


@media print {
  body { font-size: 100%; }
  a:after { content: " (" attr(href) ")"; }
  a, a:link, a:visited, a:after {
    text-decoration: underline;
    text-shadow: none !important;
    background-image: none !important;
    background: white;
    color: black;
  }
  abbr[title] { border-bottom: 0; }
  abbr[title]:after { content: " (" attr(title) ")"; }
  img { page-break-inside: avoid; }
  @page { margin: 2cm .5cm; }
  h1, h2, h3 { page-break-after: avoid; }
  p3 { orphans: 3; widows: 3; }
  img {
    max-width: 250px !important;
    max-height: 250px !important;
  }
  nav, aside { display: none; }
}

ul.with_columns {
  column-count: 1;
}
@media (min-width: 20em) {
  ul.with_columns {
    column-count: 2;
  }
}
@media (min-width: 50em) {
  ul.with_columns {
    column-count: 3;
  }
}
ul.with_two_columns {
  column-count: 1;
}
@media (min-width: 20em) {
  ul.with_two_columns {
    column-count: 1;
  }
}
@media (min-width: 50em) {
  ul.with_two_columns {
    column-count: 2;
  }
}

.gallery {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-around;
}
  .gallery figure img {
    margin-left: 1rem;
    margin-right: 1rem;
  }
  .gallery figure figcaption {
    font-family: 'ConcourseT3'
  }

footer {
  font-family: 'ConcourseT3';
  display: flex;
  flex-direction: column;
  border-top: 3px solid white;
  padding: 4rem 0;
  background-color: #07486c;
  color: white;
}
  footer > * {
    max-width: 50rem;
    margin: 0 auto;
  }
  footer a {
    color: #f1c40f;
  }
  footer .avatar {
    width: 200px;
    height: 200px;
    border-radius: 50%;
    float: left;
    -webkit-shape-outside: circle();
    shape-outside: circle();
    margin-right: 2rem;
    padding: 2px 5px 5px 2px;
    background: white;
    border-left: 1px solid #f1c40f;
    border-top: 1px solid #f1c40f;
    border-right: 5px solid #f1c40f;
    border-bottom: 5px solid #f1c40f;
  }
</style>

<h1 class="single">
  <span><a id="jumper" href="#jumpto" title="Un peu perdu ?">?</a></span>
  Collaboration technique
  <time>Publié le 14 avril 2015</time>
</h1>
<article class="single">
  <p>J’ai eu l’occasion <a href="/david/blog/2015/formations-explorations/">de transmettre</a> et <a href="/david/pro/accompagnement/">d’accompagner</a> dans la même journée <a href="http://www.natural-solutions.eu/">Natural-Solutions</a> sur le thème de « <strong>Collaborer efficacement autour du code</strong> ». Voici une petite synthèse des échanges et propositions, merci à Olivier et Gilles pour leur confiance. Merci à Vincent pour son accompagnement et sa relecture.</p>
<h2>Référentiel commun</h2>
<blockquote>
<p>What I miss · Most of al­l, the bug track­er. Any em­ploy­ee can file a bug against any prod­uct and be cer­tain that some­one on the en­gi­neer­ing team will at least look at it. There are cer­tain internal-social-engineering tech­niques you can use to fo­cus at­ten­tion on an is­sue you think isn’t get­ting enough. Lots of bug re­ports are feature-requests and oth­ers are feature-removal de­mand­s, and that’s fine.</p>
<p><cite><em><a href="https://www.tbray.org/ongoing/When/201x/2015/03/29/Anniversaries">Google + 1yr</a></em> (<a href="/david/cache/cd48ce5c2d83f8fa7b4c0a957db0d333/">cache</a>)</cite></p>
</blockquote>
<p>Il s’agit du conteneur de la valeur technique de l’entreprise. Il est capital de faire un choix stratégique sur ce point et je n’ai pas de solution miracle. À peu près tous les systèmes que j’ai pu tester étaient déficients et contraignants. Il faut au minimum que le système comporte des identifiants uniques et du contenu editable par toutes les parties prenantes. Il vaut mieux qu’il soit pérenne car il est la meilleure source d’investigation des bugs.</p>
<p>En effet, chaque <em>commit</em> doit comporter une référence à la tâche renseignée dans ce référentiel qui documente les raisons d’une telle implémentation. Les messages de <em>commit</em> <a href="https://github.com/davidbgk/git-style-guide">sont très importants</a> car ils doivent aider vos successeurs lors d’un <em>blame</em> (qui porte assez mal son nom). Le lien est ainsi fait entre chaque ligne de code et chaque développement de fonctionnalité ou correction de bug. Ne pas perdre de vue qu’il faut pouvoir avoir une vue synthétique de ce référentiel (<a href="https://robinpowered.com/blog/best-practice-system-for-organizing-and-tagging-github-issues/">un bon classement</a> (<a href="/david/cache/986d37a75df767708b9e348e71b07345/">cache</a>) est une aide précieuse).</p>
<p>J’ai de plus en plus tendance à commencer à coder en rédigeant mon message de <em>commit</em> de façon détaillée, cela permet d’avoir les idées claires sur les tenants et les aboutissants avant même de faire la première ligne de code. C’est ce message qui aidera le <em>reviewer</em> et potentiellement l’assurance qualité ensuite. Cela rejoint le <a href="http://tom.preston-werner.com/2010/08/23/readme-driven-development.html">Readme Driven Development</a> (<a href="/david/cache/053cc2e6338158d83f898d2d0f5912a8/">cache</a>).</p>
<h3>Cas particulier : monorepo</h3>
<blockquote>
<p>When it comes to repository hosting conversions, I agree with Google and Facebook: <strong>I prefer monolithic repositories</strong>. When I am interacting with version control, I just want to get stuff done. I don’t want to waste time dealing with multiple commands to manage multiple repositories. I don’t want to waste time or expend cognitive load dealing with submodule, sub repository, or big files management. I don’t want to waste time trying to find and reuse code, data, or documentation. I want everything at my fingertips, where it can be easily discovered, inspected, and used. Monolithic repositories facilitate these workflows more than separate repositories and make me more productive as a result.</p>
<p><cite><em><a href="http://gregoryszorc.com/blog/2014/09/09/on-monolithic-repositories/">On Monolithic Repositories</a></em> (<a href="/david/cache/7baab90810027d42259e14006a420074/">cache</a>)</cite></p>
</blockquote>
<p>J’ai longtemps trouvé cela abscons mais je reviens un peu sur ma position (je ne suis pas prêt à bosser pour Google ou Facebook pour autant…), avoir un dépôt pour l’ensemble des projets peut encourager la collaboration transversalement dans les équipes et le partage de code entre les produits.</p>
<h2>Relecture continue</h2>
<blockquote>
<p>As in Maslow’s pyramid, each layer requires the previous one. It is useless for code that is charging the wrong customer to be readable. Code should be:</p>
<ul>
<li>Correct</li>
<li>Secure</li>
<li>Readable</li>
<li>Elegant</li>
<li>Altruist</li>
</ul>
<p><cite><em><a href="http://blog.d3in.org/post/111338685456/maslows-pyramid-of-code-review">Maslow’s pyramid of code review</a></em> (<a href="/david/cache/b6f259d122890a04a89b658b364f62cd/">cache</a>)</cite></p>
</blockquote>
<p>L’auto-évaluation est assez mauvaise, on peut relire 15 fois son code et pourtant passer à côté de bugs qui vont être évidents au premier coup d’œil par un pair. Je l’ai expérimenté de nombreuses fois et j’envisage difficilement de me passer d’une telle pratique aujourd’hui. Il faut bien garder à l’esprit que seul le code est évalué, pas la personne. Ça peut faire mal à l’égo mais ce n’est pas une attaque personnelle pour autant !</p>
<p>Les avantages de la <em>review</em> sont nombreux et <a href="http://julienw.github.io/parisweb-2014-bonnes-pratiques/html5/parisweb-2014-bonnes-pratiques.html">Anthony et Julien en ont parlé</a> lors de ParisWeb, de même <a href="http://www.paris-web.fr/2014/conferences/100-de-revue-de-code.php">qu’Agnès</a> :</p>
<ul>
<li>diffuser la connaissance dans l’équipe</li>
<li>augmenter la cohérence du code au sein des projets</li>
<li>partager la responsabilité et son poids</li>
</ul>
<h3>Cas particulier : pair-programming</h3>
<p>Si vous êtes 2 dans l’équipe et que vous pair-programmez, qui va  relire vos développements ? Est-ce que le fait d’être en paire constitue une relecture suffisante ? Nous avons été confrontés à ce problème <a href="http://agopian.info/blog/">avec Mathieu</a> et je n’ai pas d’avis tranché sur la question si ce n’est d’essayer d’avoir une troisième personne dans l’équipe ! Parfois même un collègue sur un autre produit peut être pertinent.</p>
<h2>Flux de travail</h2>
<blockquote>
<p>We don’t want humans waiting on computers. We want computers waiting on humans.</p>
<p><cite><em><a href="http://gregoryszorc.com/blog/2015/03/28/notes-from-facebook%27s-developer-infrastructure-at-scale-f8-talk/">Notes from Facebook’s Developer Infrastructure at Scale F8 Talk</a></em> (<a href="/david/cache/add9aea6059be55754097cf61bd9eee2/">cache</a>)</cite></p>
</blockquote>
<p>En amont, on établit des conventions de développement (<a href="https://www.python.org/dev/peps/pep-0008/">pep8</a>, <a href="https://github.com/citrusbyte/styleguides/">styleguides</a>, etc) propres à l’équipe et au projet. Il est possible d’automatiser le rendu du code avec <a href="https://medium.com/@addyosmani/auto-formatting-javascript-code-style-fe0f98a923b8">JSCS</a> (<a href="/david/cache/cfdfe70dc1d0b6d3a9695c5dd3610b3e/">cache</a>) pour JavaScript ou <a href="https://github.com/google/yapf">yapf</a> pour Python par exemple.</p>
<ol>
<li>on <em>linte</em> et on teste son code pendant le développement avec les plugins propres à l’éditeur choisi </li>
<li>on soumet une <em>pull-request</em> <a href="https://quickleft.com/blog/pull-request-templates-make-code-review-easier/">bien documentée</a> (<a href="/david/cache/e9b8e370e7a0b08985827431c82f1d85/">cache</a>) (pour <a href="https://gun.io/blog/how-to-github-fork-branch-and-pull-request/">du pas à pas</a> (<a href="/david/cache/87088098369e5eadca6728c963966792/">cache</a>))</li>
<li>on teste sur un environnement aussi proche que possible de la production (possibilité d’<a href="https://realpython.com/blog/python/docker-in-action-fitter-happier-more-productive/">utiliser Docker</a> (<a href="/david/cache/37adabe90396072db9cfdd99baa61cd0/">cache</a>) par exemple)</li>
<li>on demande une <em>review</em> de son implémentation, on itère et on <em>merge</em></li>
<li>on déploie sur un environnement identique à la production qui est testable/montrable</li>
<li>on déploie en production avec une possibilité de <em>rollback</em> à partir d’un tag explicite</li>
</ol>
<p>Il est important de conserver <a href="http://mathieu.agopian.info/blog/latence-et-boucle-de-retroaction.html">une boucle de rétroaction courte</a> (<a href="/david/cache/f1ed7d7dff2ed14214bdf7a25dde1d74/">cache</a>) tout au long du flux. Il est possible d’introduire des <em>hooks</em> pour automatiser des tâches (par exemple <a href="https://github.com/naholyr/github-todos/wiki/Full-presentation">la création d’issues</a>). Il existe le <a href="http://www.occitech.fr/blog/2014/12/un-modele-de-branches-git-efficace/">gitflow bien connu</a> (<a href="/david/cache/7dfecff06cb91feccce15d23301c09e8/">cache</a>) ou le <a href="http://scottchacon.com/2011/08/31/github-flow.html">plus simple github flow</a> (<a href="/david/cache/5669f09e770c1bae1f4a84a753eff260/">cache</a>), dans tous les cas il est possible d’<a href="http://haacked.com/archive/2014/07/28/github-flow-aliases/">utiliser des alias</a> (<a href="/david/cache/d69a335a5162c7bf71aa35b2e7ec73a7/">cache</a>) ou des applications dédiées (SourceTree, Tower, Github, etc) pour éviter d’avoir à retenir <a href="http://www.git-attitude.fr/2014/09/15/30-options-git-qui-gagnent-a-etre-connues/">tout plein de trucs</a> (<a href="/david/cache/1cad71d948ab1aee73e88a73a0112df4/">cache</a>).</p>
<h3>Cas particulier : déploiement non-continu</h3>
<p>Certains déploiements doivent se produire avec une régularité calendaire ou pour un événement spécial. Dans ce cas, le flux de travail est altéré. Il est important que la pré-production soit vraiment iso-fonctionnelle pour pouvoir effectuer des tests de montée en charge et/ou que la programmation du déploiement puisse être automatisée. Des outils comme <a href="http://www.fabfile.org/">Fabric</a>, Chef, Puppet ou Ansible peuvent être utiles pour automatiser les déploiements. Ou juste <a href="https://github.com/remind101/deploy">un script</a> tirant partie des <a href="https://developer.github.com/v3/repos/deployments/">déploiements Github</a> déjà mieux qu’un <code>git pull</code> sur le <code>HEAD</code> de <code>master</code>.</p>
<h2>Documentation</h2>
<blockquote>
<p>What does discoverability and consistency mean? It means producing software (hopefully) free from the artifacts of bias, as agreed upon by your team. Do you have to use Rails or protobuf to be discoverable and consistent? Of course not. But you should seek to gain consensus. Here is a simple guide to becoming more consistent and discoverable in your codebase.</p>
<p><cite><em><a href="http://localshred.github.io/consistency.html">Consistency</a></em> (<a href="/david/cache/60d8082d551627ee8c83c1d7da9b4213/">cache</a>)</cite></p>
</blockquote>
<p>La première étape est de documenter l’installation initiale du projet et de réduire celle-ci à 3 étapes (ou moins !). J’ai croisé tellement de projets en <em>open-source</em> qui sont impossibles à installer que ça en est déprimant. Le pire étant que les auteurs se trouvent dans l’incompréhension et sont déçus de n’avoir aucune participation externe… L’optimisation de la prise en main est essentielle à l’intégration de nouvelles personnes sur le projet. Cela doit être votre priorité numéro 1 si vous souhaitez <em>vraiment</em> libérer un produit. Les outils existent pour <a href="http://agileek.github.io/docker/2015/04/13/docker-ansible/">avoir un poste de développement rapidement</a> (<a href="/david/cache/1f566c364ea0d8e96da00f38ecb08651/">cache</a>), n’hésitez pas à les utiliser (et à les maintenir à jour).</p>
<blockquote>
<p>If people <em>are</em> working from the same location, it is important that they do not skimp on writing things down.</p>
<p><cite><em><a href="https://about.gitlab.com/2015/04/08/the-remote-manifesto/">The Remote Manifesto</a></em> (<a href="/david/cache/b51c1c6daa60f39f6d088712176d766f/">cache</a>)</cite></p>
</blockquote>
<p>Il est très utile également de documenter les décisions techniques stratégiques au cours du cycle de vie d’un projet. C’est le seul moyen de ne pas rediscuter indéfiniment les mêmes choix et de reproduire les mêmes erreurs. C’est peut-être la transition culturelle la plus difficile à effectuer pour une équipe interne qui utilise surtout l’oralité pour les prises de décisions.</p>
<p>Les <a href="http://styleguides.io/">styleguides</a> sont <a href="http://primercss.io/">à la mode</a> et au-delà de <a href="https://medium.com/@operatino/living-style-guide-tools-in-depth-overview-28cfffb92d05">l’aspect marketing</a> (<a href="/david/cache/ff9dd5355d2a5b57988ebcfbd74f77b3/">cache</a>), il est possible d’avoir une base rapidement qui sert à maintenir la cohérence entre les différents composants d’une application web. Des <a href="https://trulia.github.io/hologram/">outils</a> <a href="https://github.com/kneath/kss">existent</a> pour <a href="http://jacobrask.github.io/styledocco/">automatiser</a> sa génération, l’utilisation d’<a href="http://www.alsacreations.com/article/lire/1641-bonnes-pratiques-en-css-bem-et-oocss.html">une approche OOCSS/BEM</a> rend les éléments plus simples à isoler/documenter.</p>
<p>J’ai tendance à penser que la dette technique est inévitable (mais je n’ai pas encore pris le temps de lire <a href="http://boutique.letrainde13h37.fr/products/la-dette-technique-bastien-jaillot">le bouquin de Bastien</a> sur le sujet ;-)). Partant de ce constat, il y a deux choses à surveiller :</p>
<ul>
<li>que la taille du code reste raisonnable en restant le plus pertinent possible sur la valeur apportée à l’utilisateur</li>
<li>qu’il n’y ait pas de relâchement sur la qualité en cas de rush ou de fatigue, situations où l’on a tendance à débrayer</li>
</ul>
<h3>Cas particulier : The Big Rewrite™</h3>
<blockquote>
<p>It’s important to remember that when you start from scratch there is <strong>absolutely no reason</strong> to believe that you are going to do a better job than you did the first time. First of all, you probably don’t even have the same programming team that worked on version one, so you don’t actually have « more experience ». You’re just going to make most of the old mistakes again, and introduce some new problems that weren’t in the original version. </p>
<p><cite><em><a href="http://www.joelonsoftware.com/articles/fog0000000069.html">Things You Should Never Do, Part I</a></em> (<a href="/david/cache/136e6aaaf23c95e360dcf6428dade480/">cache</a>)</cite></p>
</blockquote>
<p>C’est quelque chose que j’ai tenté dans une précédente vie lorsque j’ai réécrit une application de gestion de traçabilité dédiée aux laboratoires. Avec 10 années de recul, je pense que c’était une erreur. Non pas de réécrire mais de ne pas avoir évalué l’inertie du changement de culture associé en interne pour combiner une réécriture ET une simplification.</p>
<p>Si vous <a href="http://blog.aelogica.com/development/rewrite-not-question/">prenez cette voie</a> (<a href="/david/cache/effe69ce88eb3a3bc286767b15197de3/">cache</a>), documentez chaque raison de la réécriture et chaque décision prise au cours de celle-ci.</p>
<h2>Discussion</h2>
<blockquote>
<p>Read the Docs, sadly, is still heavily dependent on me being around to operate it. Our campaign to make it more sustainable is the first step towards hopefully fixing this situation. Operating and supporting the site has started to take most of my time, not leaving much room for building community and on boarding contributors. In fact, it leads to an implicitly hostile environment for new contributors, because nobody was around to help them, test their patches, and get changes into the codebase.</p>
<p><cite><em><a href="http://ericholscher.com/blog/2015/apr/10/making-read-the-docs-sustainable/">Making Read the Docs Sustainable</a></em> (<a href="/david/cache/bb89afe29cd75835fd7df428b44b9759/">cache</a>)</cite></p>
</blockquote>
<p>La matinée de formation a été suivie d’une après-midi d’accompagnement qui nous a permis de mettre en application un <em>workflow</em> de travail basé sur git(hub) pour encourager les revues de code et les participations externes.</p>
<p>J’en retiens trois discussions, la première sur le financement de l’<em>open-source</em> où il a été question de développement à base de <em>crowdfounding</em>, voire de <em>companyfounding</em> pour mutualiser les coûts ? Cela m’a rappelé la discussion que nous avions eue avec <a href="http://simons.fr/">Simon</a> lors de <a href="http://moustic.info/2015/wakka.php?wiki=PagePrincipale">MousTIC</a> sur <a href="http://unisson.co/fr/wiki/prestation/">le financement des communs</a> (<a href="/david/cache/817d232d98ee6c2e5f266582c3c47628/">cache</a>).</p>
<p>La seconde portait sur la gestion de l’inclusion de modules non <em>open-source</em> dans un projet <em>open-source</em>, je n’ai pas de solution pour cela à part essayer de faire une architecture qui permet l’inclusion de <em>plugins</em> mais cela reste limité. Si vous avez des suggestions/expériences je suis preneur.</p>
<p>Enfin, la dernière était relative à l’inclusion des contributeurs externes sur un projet <em>open-source</em>, en plus de la documentation d’installation du projet déjà évoquée, j’ai proposé :</p>
<ul>
<li>documenter pourquoi est-ce que le projet a été mis en open-source et quelles sont les attentes au niveau des contributions</li>
<li>documenter comment est-ce que le projet peut recevoir des améliorations (quel <em>workflow</em>, quels tests, quelle réactivité)</li>
<li>identifier clairement des bugs qui sont faciles à prendre pour rentrer dans le projet</li>
<li>proposer d’avoir une position de <em>mentor</em> sur certains bugs pour accompagner les débutants</li>
<li>discuter de manière ouverte les décisions et les orientations du projet avec la communauté</li>
</ul>
<p>C’est un travail fastidieux qui ne porte ses fruits que sur le long terme et dont le retour sur investissement est difficilement quantifiable (recrutement, renommée, etc). Mais quelle joie pour l’équipe lorsque ça prend ! L’ensemble de ces réflexions m’ont amené à écrire <a href="https://github.com/davidbgk/open-source-template">un gabarit de README pour projets open-source</a> encourageant la participation. N’hésitez pas à contribuer ;-).</p>
<blockquote>
<p>Each developer in your company should have two days per month to work on the open source software your product is built on.</p>
<p>[…]</p>
<p>The real reason you should do it is because it will make your product better, make your developers better, and make your company a more attractive place to work.</p>
<p><cite><em><a href="http://twodaymanifesto.com/">The Two Day Manifesto</a></em> (<a href="/david/cache/73fc8424bbfbf91a8f75db7060a24aea/">cache</a>)</cite></p>
</blockquote>
<p>Au final, c’était un plaisir d’accompagner une équipe dans sa recherche de pertinence autour de <a href="https://github.com/NaturalSolutions">ses produits</a> <em>open-source</em>, j’espère vraiment que l’on pourra inscrire cette relation de confiance dans la durée.</p>
</article>


  <figure class="image" property="schema:image">
    <img src="/static/david/blog/2015/collaboration-technique.jpg" alt="" />
  </figure>


<nav id="jumpto">
  <p>
    <a rel=prev href="/david/blog/2015/coworking-transition/">← Co-working en transition</a> | <a href="/david/blog/" title="Retour à la liste des expériences">↑</a> | <a rel=next href="/david/blog/2015/chiffrer-emails/">Chiffrer ses emails →</a>
  </p>
</nav>

<footer>
  <div>
    <img src="/static/david/david-larlet-avatar.jpg" loading="lazy" class="avatar" width="200" height="200">
    <p>
      Bonjour/Hi!
      Je suis <a href="/david/" title="Profil public">David&nbsp;Larlet</a>, je vis actuellement à Montréal et j’alimente cet espace depuis 15 ans. <br>
      Si tu as apprécié cette lecture, n’hésite pas à poursuivre ton exploration. Par exemple via les <a href="/david/blog/" title="Expériences bienveillantes">réflexions bimestrielles</a>, la <a href="/david/stream/2019/" title="Pensées (dés)articulées">veille hebdomadaire</a> ou en t’abonnant au <a href="/david/log/" title="S’abonner aux publications via RSS">flux RSS</a> (<a href="/david/blog/2019/flux-rss/" title="Tiens c’est quoi un flux RSS ?">so 2005</a>).
    </p>
    <p>
      Je m’intéresse à la place que je peux avoir dans ce monde. En tant qu’humain, en tant que membre d’une famille et en tant qu’associé d’une coopérative. De temps en temps, je fais aussi des <a href="https://github.com/davidbgk" title="Principalement sur Github mais aussi ailleurs">trucs techniques</a>. Et encore plus rarement, <a href="/david/talks/" title="En ce moment je laisse plutôt la place aux autres">j’en parle</a>.
    </p>

      <p>
        Les dernières publications hebdomadaires sont :
      </p>
      <ul class="with_columns">

          <li>
            <a href="/david/stream/2019/12/31/">Merci</a>
          </li>

          <li>
            <a href="/david/stream/2019/12/27/">Intemporels</a>
          </li>

          <li>
            <a href="/david/stream/2019/12/24/">Outils</a>
          </li>

          <li>
            <a href="/david/stream/2019/12/17/">Origines</a>
          </li>

          <li>
            <a href="/david/stream/2019/12/10/">Publier</a>
          </li>

          <li>
            <a href="/david/stream/2019/12/03/">En forêt</a>
          </li>

          <li>
            <a href="/david/stream/2019/11/26/">Ecocentric</a>
          </li>

          <li>
            <a href="/david/stream/2019/11/19/">Se livrer</a>
          </li>

          <li>
            <a href="/david/stream/2019/11/12/">Dépendances</a>
          </li>

          <li>
            <a href="/david/stream/2019/11/05/">Positif</a>
          </li>

          <li>
            <a href="/david/stream/2019/10/29/">Dettes</a>
          </li>

          <li>
            <a href="/david/stream/2019/10/22/">Privilèges</a>
          </li>

          <li>
            <a href="/david/stream/2019/10/15/">Discrétion</a>
          </li>

          <li>
            <a href="/david/stream/2019/10/08/">Désespérance</a>
          </li>

          <li>
            <a href="/david/stream/2019/10/01/">Présent</a>
          </li>

          <li>
            <a href="/david/stream/2019/09/24/">Manifester</a>
          </li>

          <li>
            <a href="/david/stream/2019/09/17/">Arpenter</a>
          </li>

          <li>
            <a href="/david/stream/2019/09/10/">Nostalgie</a>
          </li>

          <li>
            <a href="/david/stream/2019/09/03/">Déconstruire</a>
          </li>

          <li>
            <a href="/david/stream/2019/08/27/">Documenter</a>
          </li>

          <li>
            <a href="/david/stream/2019/08/20/">Frustration</a>
          </li>

          <li>
            <a href="/david/stream/2019/08/13/">Holisme</a>
          </li>

          <li>
            <a href="/david/stream/2019/08/06/">1%</a>
          </li>

          <li>
            <a href="/david/stream/2019/07/30/">Exemplarité</a>
          </li>

          <li>
            <a href="/david/stream/2019/07/23/">Timelines</a>
          </li>

          <li>
            <a href="/david/stream/2019/07/16/">Écoute</a>
          </li>

          <li>
            <a href="/david/stream/2019/07/02/">Anxiété</a>
          </li>

          <li>
            <a href="/david/stream/2019/06/21/">À lier</a>
          </li>

          <li>
            <a href="/david/stream/2019/06/14/">Pauvreté</a>
          </li>

          <li>
            <a href="/david/stream/2019/06/07/">Amateur</a>
          </li>

          <li>
            <a href="/david/stream/2019/05/31/">Pollution</a>
          </li>

          <li>
            <a href="/david/stream/2019/05/24/">Apaisement</a>
          </li>

          <li>
            <a href="/david/stream/2019/05/10/">Folie</a>
          </li>

          <li>
            <a href="/david/stream/2019/05/03/">Sympathie</a>
          </li>

          <li>
            <a href="/david/stream/2019/04/12/">Péremption</a>
          </li>

          <li>
            <a href="/david/stream/2019/04/05/">Définitions</a>
          </li>

          <li>
            <a href="/david/stream/2019/03/29/">Acceptation</a>
          </li>

          <li>
            <a href="/david/stream/2019/03/22/">Dissonance</a>
          </li>

          <li>
            <a href="/david/stream/2019/03/15/">Reconnaissance</a>
          </li>

          <li>
            <a href="/david/stream/2019/03/08/">Lecture</a>
          </li>

          <li>
            <a href="/david/stream/2019/03/01/">Journaux</a>
          </li>

          <li>
            <a href="/david/stream/2019/02/22/">Écriture</a>
          </li>

          <li>
            <a href="/david/stream/2019/02/15/">Kyriarchie</a>
          </li>

          <li>
            <a href="/david/stream/2019/02/08/">Mots-serrures</a>
          </li>

          <li>
            <a href="/david/stream/2019/02/01/">Sans voie</a>
          </li>

          <li>
            <a href="/david/stream/2019/01/25/">Auto-diagnostic</a>
          </li>

          <li>
            <a href="/david/stream/2019/01/18/">Agilité</a>
          </li>

          <li>
            <a href="/david/stream/2019/01/11/">Métaphores</a>
          </li>

          <li>
            <a href="/david/stream/2019/01/04/">Balbutiements</a>
          </li>

      </ul>

    <p>
      Voici quelques articles choisis :
      <a href="/david/blog/2019/faire-equipe/" title="Accéder à l’article complet">Faire équipe</a>,
      <a href="/david/blog/2018/bivouac-automnal/" title="Accéder à l’article complet">Bivouac automnal</a>,
      <a href="/david/blog/2018/commodite-effondrement/" title="Accéder à l’article complet">Commodité et effondrement</a>,
      <a href="/david/blog/2017/donnees-communs/" title="Accéder à l’article complet">Des données aux communs</a>,
      <a href="/david/blog/2016/accompagner-enfant/" title="Accéder à l’article complet">Accompagner un enfant</a>,
      <a href="/david/blog/2016/senior-developer/" title="Accéder à l’article complet">Senior developer</a>,
      <a href="/david/blog/2016/illusion-sociale/" title="Accéder à l’article complet">L’illusion sociale</a>,
      <a href="/david/blog/2016/instantane-scopyleft/" title="Accéder à l’article complet">Instantané Scopyleft</a>,
      <a href="/david/blog/2016/enseigner-web/" title="Accéder à l’article complet">Enseigner le Web</a>,
      <a href="/david/blog/2016/simplicite-defaut/" title="Accéder à l’article complet">Simplicité par défaut</a>,
      <a href="/david/blog/2016/minimalisme-esthetique/" title="Accéder à l’article complet">Minimalisme et esthétique</a>,
      <a href="/david/blog/2014/un-web-omni-present/" title="Accéder à l’article complet">Un web omni-présent</a>,
      <a href="/david/blog/2014/manifeste-developpeur/" title="Accéder à l’article complet">Manifeste de développeur</a>,
      <a href="/david/blog/2013/confort-convivialite/" title="Accéder à l’article complet">Confort et convivialité</a>,
      <a href="/david/blog/2013/testament-numerique/" title="Accéder à l’article complet">Testament numérique</a>,
      et <a href="/david/blog/" title="Accéder aux archives">bien d’autres…</a>
    </p>
    <p>
      On peut <a href="mailto:david%40larlet.fr" title="Envoyer un courriel">échanger par courriel</a>. Si éventuellement tu souhaites que l’on travaille ensemble, tu devrais commencer par consulter le <a href="http://larlet.com">profil dédié à mon activité professionnelle</a> et/ou contacter directement <a href="http://scopyleft.fr/">scopyleft</a>, la <abbr title="Société coopérative et participative">SCOP</abbr> dont je fais partie depuis six ans. Je recommande au préalable de lire <a href="/david/blog/2018/cout-site/" title="Attention ce qui va suivre peut vous choquer">combien coûte un site</a> et pourquoi je suis plutôt favorable à une <a href="/david/pro/devis/" title="Discutons-en !">non-demande de devis</a>.
    </p>
    <p>
      Je ne traque pas ta navigation mais mon
      <abbr title="Alwaysdata, 62 rue Tiquetonne 75002 Paris, +33.184162340">hébergeur</abbr>
      conserve des logs d’accès.
    </p>
  </div>
</footer>
<script type="text/javascript">
  ;(_ => {
    const jumper = document.getElementById('jumper')
    jumper.addEventListener('click', e => {
      e.preventDefault()
      const anchor = e.target.getAttribute('href')
      const targetEl = document.getElementById(anchor.substring(1))
      targetEl.scrollIntoView({behavior: 'smooth'})
    })
  })()
</script>

  <script>
  /* Service workers */
  if (navigator.serviceWorker) {
    window.addEventListener('load', function () {
      var selector = 'a[href^="/david/cache/"], a[rel=prev], a[rel=next]'
      function sendLinks (selector) {
        var links = [].slice.call(document.querySelectorAll(selector)).map(function (link) {
          return link.getAttribute('href')
        })
        links.push(location.pathname)  // Put the current page in cache too.
        navigator.serviceWorker.controller.postMessage({ links: links })
      }
      navigator.serviceWorker.getRegistration()
        .then(function (registration) {
          if (!registration || !navigator.serviceWorker.controller) {
            return navigator.serviceWorker.register('/serviceworker.js')
              .then(navigator.serviceWorker.ready)
              .then(function () {
                console.log('[ServiceWorker] Ready to go!')
              })
              .catch(console.error.bind(console))
          } else {
            console.log('[ServiceWorker] Send links via registration')
            sendLinks(selector)
          }
        })
      navigator.serviceWorker.addEventListener('controllerchange', function () {
        console.log('[ServiceWorker] Send links via controller change')
        sendLinks(selector)
      })
      navigator.serviceWorker.addEventListener('message', function (event) {
        var link = document.querySelector('a[href="' + event.data.link + '"]')
        if (event.data.status && link) {
          link.style.backgroundColor = '#2d7474'
          link.style.color = '#f0f0ea'

            link.setAttribute('title', 'En cache pour consultation sans connexion')

        }
      })
    })
  } else {
    console.warn('[ServiceWorker] No cache for old browsers.')
  }
</script>