Blogs où trouver de vraies solutions ?

Voici un blog cool, une communauté qui à l'air sympa. Oui je suis outré par la démarche Internet de "Comment ça marche" un forum de mer(bip) avec aucune solution. Vous avez un problème, avec "Comment ça marche" vous restez avec.

Je ne sais pas comment ces gens ont fait mais leur système de blog est si pourri qu'il n'y a jamais de solution, ils agrègent des posts merdiques sans faire de modération, du coup vous vous retrouver à lire des posts interminables sans intérêt écris par des benêts et en bas toujours pas de solution à votre problème. Par contre il sont référencés entête dans les pages.

Alors dès que je peux, je cite les blogs qui eux fournissent de véritables solutions, voici une communauté intéressante à étudier : hack.guides



pluralsight - A reliable resource for just-in-time answers

C'est assez curieux comme approche toutes ces pages qui sont là exposées ... Certainement pour le SEO et après ils vendent des cours en ligne mais les articles sont réellement de qualité.

Hristo Georgiev - Introduction to Angular test-driven development
Il s'agit d'utiliser "karma" pour faire du TDD et ça à l'air assez complet. Donc voilà une vraie solution pour un vrai problème.

Have Fun!

Générer la documentation à partir des codes sources

Vous cherchez un outil de génération de la documentation à partir des codes sources, on va voir ce que nous avons aujourd'hui sur le marché.

C'est toujours extrêmement pénible pour des raisons de normes qualité essentiellement d'avoir à produire des documents qui sont en fait la "paraphrase du codes sources" je le dis souvent si vous n'êtes pas capable de lire les codes sources ce n'est pas la peine de travailler dans l'édition logicielle.

Mais souvent cet argument est mal compris voir mal perçu. Alors pour faire taire toutes les critiques, écrivons des sources codes correctement documentés et générons automatiquement les docs pour le service qualité à partir de nos sources codes.

C'est compliqué d'avoir déjà des templates de sources codes agréables à utiliser. Donc une des fonctionnalités importante, essentielle du générateur de documentation c'est le "Template personnalisable" ainsi on pourra conserver nos propres Templates si chéris. En effet la plupart du temps les générateurs de doc ont le défaut de vous imposer le Template ...

Par la suite, je suis surpris de découvrir que chaque langage à son générateur de doc. Je tombe alors sur Wikipédia qui nous parle de Doxygen :

Generate documentation from source code

Wikipédia - Doxygen

https://www.stack.nl/~dimitri/doxygen/
http://www.stack.nl/~dimitri/doxygen/download.html

L'avantage : il est multilangage mais surtout pour le langage C/C++. Personnellement j'ai essayé de le mettre en place à partir des sources codes que j'avais en C/C++ avec des templates que j'affectionne particulièrement, je n'y suis pas arrivé, mes Templates ne lui plaisent sans doute pas mais je ne désespère pas.

Je vous laisse découvrir les autres générateurs sur la page de Wikipédia : Ici

Voilà, je tenais surtout à prendre note de Doxygen. Pour le reste cette génération automatique de doc ce n'est pas et cela ne sera jamais, la panacée. Soit la doc est pourrie soit on pourri le code avec des balises de génération de doc. Le code c'est la bible, la seule chose qui compte mais allez expliquer ça à une bande d'incapables qui trouve cela trop compliqué à lire.

Si vous avez d'autre de vos outils préférés qui featurerisent les même contraintes :

• Template configurable de façon souple
• Multilangage

N'hésitez pas à nous en faire part en commentaires.

Have fun!