davidbgk
/
larlet-fr-david
Suivre 1
Ajouter aux favoris 0
Bifurcation 0
Code Versions 0 Activité
Repository with sources and generator of https://larlet.fr/david/ https://larlet.fr/david/
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
30 Révisions
1 Branche
Aborescence: 78ab58b3bb
Branches Tags
${ item.name }
Créer la branche ${ searchTerm }
de '78ab58b3bb'
${ noResults }
larlet-fr-david/david/stream/2018/01/19/index.md

index.md 1.5KB
Brut Vue normale Historique

Add initial content
il y a 4 ans
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
 12345678910111213141516 
  1. title: Commit (hi)story

  2. lang: en 

  3. 

  4. > There is one tool that we under utilise in our communities for communicating our intent and that is our version control system. […]

  5. >

  6. > Our commit history has some very special properties which make it particularly useful for documenting intent.

  7. >

  8. > It is kept forever.

  9. >

  10. > It is always up to date and this almost certainly not true of most of the documentation you have, perhaps in a wiki or even in code comments.

  11. >

  12. > And, this may come as a surprise to some of you, it is searchable.

  13. >

  14. > <cite>*[Telling stories through your commits](https://blog.mocoso.co.uk/talks/2015/01/12/telling-stories-through-your-commits/)* ([cache](/david/cache/13d9da5621e5616aee2248696390c693/))</cite>

  15. 

  16. Even if I try to write [good commit messages](https://chris.beams.io/posts/git-commit/) ([cache](/david/cache/47c163111260f462fa10532e784a4c44/)), I never thought about actually using it as an [up-to-date line by line documentation](https://about.futurelearn.com/blog/telling-stories-with-your-git-history) ([cache](/david/cache/3298d68a0ad3d267742d80811213d628/)). Which lead me to think about a more friendly way to visualize it. Using [git blame or any other git trickery](https://mislav.net/2014/02/hidden-documentation/) ([cache](/david/cache/d92f0d39965b2b41d2701d3a6a114c3c/)) is a bit too nerdy for me. I’m still looking for the most [appropriated plugin](https://packagecontrol.io/search/git?sort=popularity) for my editor which would display the commit message related to each line without the hurdle of doing it by hand.