Documenter vos projets autrement avec git et asciidoc

Un collègue m’a fourni une vidéo intéressante sur une manidère différente de gérer une documentation projet : https://youtu.be/1rKgVF5CEEY

Il est vrai que cela fait un moment qu’on tourne autour du pot. Les wikis c’est bien mais le bon logiciel est toujours délicat à trouver. Sans détailler la réflexion ici (peut être une autre fois) il y a toujours une contrainte qui fait que ce n’est jamais parfait…

Je suis donc en train de me pencher sur une mouvance qui me semble intéressante : gérer sa documention as a code. En simplifiant cela veut dire que votre documentation est gérée dans un dépot git, avec un outil de collaboration sympa comme gitlab et  des fichiers sous forme plain text avec une syntaxe simple et lisible comme markdown ou asciidoc (j’ai tendance à préférer le second actuellement).

Cela vous permet d’avoir une documentation où chacun peut collaborer simplement (coucou pull request). De plus, il se trouve que github et gitlab intègrent les syntaxes asciidoc et markdown en natif, vous pouvez donc déjà naviguer dans votre documentation directement sur leur site web.

Le fin du fin sera de générer un site statique joli (avec un moteur de recherche) et si possible une version pdf. C’est là que l’excellent gitbook entre en action.

Enfin, pour mettre la cerise sur le gateau, vous pouvez rebuilder votre site documentaire de manière automatisée avec un job gitlab ci bien senti.

Au passage, pour le job gitlab je me suis construit une image docker gitbook qui m’aide bien.

Cette manière de faire semble s’étendre car même chez owasp on a choisi de construire le nouveau developer guide de cette manière sur github.

Que du bon donc pour l’instant ! A creuser à l’usage.

More

UTMB® – Sommet mondial du trail-running – Inscriptions 2017

100km & 6 000 m  D+1 900 coureursDépart vendredi 01/09/2017à 9:00 de Courmayeur

Source : UTMB® – Sommet mondial du trail-running – Inscriptions 2017

Et voilà, pré inscription faite à la CCC 2017. Tirage au sort début janvier 2017.

Pas en forme, blessé depuis 7 mois maintenant mais pas encore mort ! On y croit !

More

OSMC

OSMC is a free and open source media center built for the people, by the people.

Source : OSMC

Un excellent media center avec kodi le tout sous forme de distribution linux qui par exemple va à ravir avec un Raspberry pi. Ce n’est pas une nouveauté mais je test depuis peu et j’en suis très satisfait !

Il existe de nombreux plugins intéressants dont notamment vStream pour Kodi.

Bravo aux développeurs !

More

Face au risque de fork, Docker met en Open Source son runtime

Docker a entendu les critiques et y répond. La société vient d’annoncer la mise en Open Source du runtime de son Docker Engine nommé Containerd. Nous nous étions fait l’écho en septembre dernier d’une grogne au sein de la communauté, grogne portant sur la façon dont la start-up fondée par des anciens de l’Epitech gère le Docker Engine, le runtime maison permettant de construire et faire tourner des conteneurs. D’où l’idée d’un fork, un dérivé du code Open Source appelé à vivre sa propre vie indépendamment de Docker. Celui-ci viserait aussi à régler différents problèmes relatifs aux déploiements en entreprise. Notamment les questions de stabilité, un prérequis pour espérer supporter des déploiements massifs au sein de grandes entreprises.

Source : Face au risque de fork, Docker met en Open Source son runtime

Pour ceux qui pensaient que docker allait trop loin. Je dirais que oui, mais dans le bon sens cette fois 🙂

More