Documenter mon projet open-source rapidement

Documenter mon projet open-source rapidement

Je reçois beaucoup de questions sur les outils à utiliser. J’ai décidé d’y répondre ici.

Comment documenter de façon économique un projet open-source, fait sur le temps libre ?

Les générateurs statiques sont très efficaces, et en version hébergée pour vous, il n’y a pas, en 2020, tant de solutions que cela. Mes recherches ont été faciles.

En fait, j’ai identifié 4 solutions pratiques qui supportent le Markdown :

  • Github Pages : un Jekyll rattaché à vos projets hébergés sur Github
  • Gitlab Pages : à vous de choisir le générateur statique qui vous convient.
  • ReadTheDocs (gratuit pour les projets open-source) : choisissez entre deux parfums, un Sphinx ou un MkDocs, pour utiliser le format de fichier qui vous convient le mieux.
  • Gitbook (gratuit pour les projets open-source) : solution propre, l’équipe est à Lyon.
Publicité

14 mai 2008 : PHP et Silverlight, développement d’applications riches

Après avoir eu des interventions sur XUL, Flex et Ajax, l’AFUP vous propose le 4è concurrent web 2.0 : Silverlight.

Des intervenants spécialistes de PHP, de chez Microsoft viennent présenter Silverlight. Une occasion unique de poser vos questions !

Après nos rendez vous sur XUL, Flex et Ajax/HTML5 venez suivre avec nous ce dernier opus sur la technologie de Microsoft : Silverlight.

Informations sur le contenu sur le blog de Christophe Lauer

La conférence s’adressera principalement à une audience technique et nous montrerons pas ma le code : du PHP bien entendu, mais aussi du XAML, du JavaScript, et sans doute du C# et du VB.NET 😉

Inscrivez vous sur le site de l’AFUP (le nombre de places est limité)

29 avril 2008 : Industrialiser les développements PHP, le cas e-TF1

Un nouveau RendezVous AFUP avec un retour d’expérience de e-TF1.

Il y a 50 places, et ce RendezVous a lieu à la FIAP (Paris 14è).

Inscrivez vous vite tant qu’il reste de la place !

e-TF1 vous propose de découvrir sa méthodologie et ses outils permettant une réelle industrialisation des projets PHP.

[+ d’infos] site AFUP

La rencontre suivante sera le 14 mai 2008, sur Silverlight.