Forum général.général cherche exemples de documentation avec belle mise en page

Posté par  (site web personnel) .
Étiquettes : aucune
0
20
juin
2012

Bonjour,

Si vous avez souvenir d'une documentation ou d'un tutoriel bien fait, agréable à lire et à utiliser, pratique, dont la mise en page est belle et lisible à la fois, partagez le lien.

Je cherche quelques exemples, pour avoir quelques repères et essayer de faire une mise en page aussi efficace que ce qui se fait de mieux en la matière.

D'avance, merci.

  • # La meillor !

    Posté par  . Évalué à 2.

    http://docs.python.org/

    "The trouble with quotes on the internet is that it’s difficult to discern whether or not they are genuine.” Abraham Lincoln

    • [^] # Re: La meillor !

      Posté par  (site web personnel) . Évalué à 2.

      Ah, j'ai oublié l'essentiel: format pdf (j'ai trouvé le lien).

      C'est vrai qu'elle est bien la version html de cette doc, mais je suis moins convaincu par le pdf, que je trouve trop dense et parfois un peu confus.

      T'en as pas une autre?

  • # Comme son nom l'indique

    Posté par  (site web personnel) . Évalué à 1.

    Une compilation de superbes documentations : https://github.com/PharkMillups/beautiful-docs dont l'insolite Why's (Poignant) Guide to Ruby

  • # linux admin

    Posté par  . Évalué à 1.

    Est-ce qu'il serait possible d'avoir de belles pages de documentation mais, pour de l'administration système ? Genre, une belle présentation comme la doc python. Un truc pas trop spécifique à une distribution en particulier. Merci

    • [^] # Re: linux admin

      Posté par  (site web personnel) . Évalué à 3.

      Ben, tu passe en Sphinx (reStructuredText) et tu as les outils qui te génèrent ta doc "belle comme la doc Python" (normalement tu peux personnaliser les styles, voir même ajouter des éléments spécifiques).

      Le problème est: de quoi tu parts ? Du neuf, de l'ancien ? Sous quel format ?

      Python 3 - Apprendre à programmer dans l'écosystème Python → https://www.dunod.com/EAN/9782100809141

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.