Requêtes de tutoriels

J'avoue que ça me plait comme idée. Je suis incapable de faire une doc correcte de mon point de vue, alors de celui des autres quand je commencerai à travailler en groupe ça m'inquiète.

Oui, il faut un tuto docker. Maintenant faut voir le niveau.

Je suis à 300% pour un tutoriel comme celui-ci ! Il est vrai que la documentation passe souvent à la trappe et pour cause on ne sait pas forcément comment faire pour que se soit organiser et clair … moi le premier

Ma proposition pour un tuto sur la météorologie est passée à la trappe ?

Ce sujet est fait pour proposer, il n'est pas dit que quelqu'un s'en occupera. Pas à court terme du moins.

Je dit ça parce qu'il n’apparaît pas dans la liste du premier post ! Je me demandais pourquoi n'avait-il pas été accepté ?

L'OP a probablement juste pas eu le temps de mettre à jour.

Autant pour moi, j'ai dû zapper quelques messages. En règle générale, j'ajoute les propositions qui récupèrent +4 ou +5, alors n'hésitez pas à me MP avec un lien si vous voyez une proposition manquante.

Hello ! Je serais partant d’écrire un tuto sur la ponctuation, mais c’est plus au niveau typographique ? Je suis pas expert, mais je peux tenter de faire quelque chose. Mais ça risque d’être court, je vois pas comment on peut faire ça. Il y a des littéraires sur le site ?

Moi j’aime bien la version gauchiste

D’ailleurs, pourquoi pas des tutos pour apprendre des langues ? Faut se trouver une méthodo sympathique, personnellement, j’ai du mal avec ce qu’on trouve sur le « marché ». Si on a un cadre, une base sur lequel se baser pour écrire les cours, ça serait bien ! (Genre : apprenez l’espéranto, le Latin, le Globish, le patois…)

Hello ! Je serais partant d’écrire un tuto sur la ponctuation, mais c’est plus au niveau typographique ? Je suis pas expert, mais je peux tenter de faire quelque chose. Mais ça risque d’être court, je vois pas comment on peut faire ça. Il y a des littéraires sur le site ?

Oui, a priori, un tuto sur la typographie en général serait plus adapté (même dans les références les plus complètes, le chapitre sur la ponctuation prend difficilement plus de 2 pages A4), mais j'avoue que je ne saurais pas comment faire plus qu'une compilation des 3-4 principales sources de référence sur le sujet…

D’ailleurs, pourquoi pas des tutos pour apprendre des langues ? Faut se trouver une méthodo sympathique, personnellement, j’ai du mal avec ce qu’on trouve sur le « marché ». Si on a un cadre, une base sur lequel se baser pour écrire les cours, ça serait bien ! (Genre : apprenez l’espéranto, le Latin, le Globish, le patois…)

Le sujet a été pas mal discuté déjà.

J’ai quelques ouvrages de références, si ça intéresse des gens !

Est-ce que je te cite comme auteur pour ce cours ?

Je dois encore réfléchir, le temps me manque, mais si je ne suis pas seul à le faire, je veux bien

Un conseil (valable pour tous les potentiels rédacteurs qui hésitent) : lancez-vous.

Le problème c'est que peu osent se lancer tout seul, du coup ils ne se lanceront jamais.
Crée un tuto en brouillon, mets quelques phrases… dès fois, quand tu auras de la motivation, rédige un plan, jette quelques phrases par-ci par là. Le plus dur, c'est de commencer une page blanche en se disant "j'ai pas beaucoup de temps là, je vais pas commencer quelque chose". Résultat : tu ne commences jamais.

Alors qu'en faisant comme ça, le jour où tu auras de la motivation, tu partiras déjà de quelque chose, même à l'état embryonnaire. Et au bout d'un an, deux ans, voire plus on s'en fiche, ben tu auras quelque chose à publier

J'ai par exemple 8 tutos en brouillon, j'y touche de temps en temps par ci par là (ou pas d'ailleurs, mais je sais que je partirais pas de zéro si je m'y remets). Et plus le tuto avance, plus j'ai de la motivation pour le continuer.

Allez, je prends les devants ! Qwerty, je te mets rédacteur, et j'invite les éventuels co-rédacteurs à se manifester parce que j'ai[^seul] très envie de voir ce cours.

Je suis le premier à râler quand je vois quelqu'un faire une faute de typo et avoir une ressource vers laquelle rediriger les hérétiques serait super, sans compter la masse de choses que je suis sûr d'ignorer à ce sujet !

Très très bonne idée Doxygen.

Nombre de fois où je vois les groupes inexploités ou l'utilisation de mots clés qui ne servent à rien là où ils le sont (\class, \function à côté de la déclaration commentée), alors que des hypers importants ne sont jamais utilisés (\pre, & cie). Le pire étant ceux qui tapent des commentaires qu'ils croient être au format Doxygen sans avoir jamais essayé de générer la doc pour voir à quoi ça ressemble où qu'elles erreurs étaient levées.

D'un autre côté si la doc n'est pas générée, peu importe que la syntaxe ne soit pas respectée à la lettre… L'important reste quand même d'avoir un codé commenté correctement.

Oui et non. L'important est que l'utilisateur s'y retrouve. Naviguer dans les sources (si tant est que les sources soient fournies, ce qui est de toujours être le cas), c'est chiant sans les liens, les diagrammes et la jolie présentation en HTML ou LaTeX.

Soit on fait une doc, soit on en fait pas.

Je n'ai jamais généré ma doc (sur mes projets perso) jusqu'à présent, et j'arrive très bien à m'en sortir ; ainsi que le développeur qui code avec moi.

À mon sens, la génération de la doc n'est pas une étape obligatoire. Si tout est rangé là où il faut avec des noms adéquats, il suffit d'un bon IDE pour s'en sortir.