Journal Du Readme.md et de sa verve

Posté par  (site web personnel) .
Étiquettes :
-40
9
déc.
2012

Bonsoir à tous,

Je suis tombé sur le journal de ife, et de fil en aiguille, je me suis retrouvé à parcourir quelques repos liés à Github.

Notamment celui-ci, qui est le moteur de rendu du wiki de github.

Et là j'ai un peu déchanté sur le sérieux de ce projet, rien qu'en lisant le Readme.

Rien que le titre et l'intro…

Redcarpet 2 is written with sugar, spice and everything nice

Redcarpet is Ruby library for Markdown processing that smells like
butterflies and popcorn.

Le reste du readme est parsemé de ces petites phrase croustillantes, qui te donnent l'impression d'être chez le marchand de bonbon, entrain d'hésiter entre les schtroumpfs ou les têtes brûlées goût pomme.

Pour moi c'est rédhibitoire, j'ai fermé la page de dégoût.

Alors journal, c'est quoi ton avis?

  • c'est la faute de Ruby, tous les Rubyistes sont obligés d'écrire des Readmes pour des gamains de 2 ans (j'ai pu l'adresse du repo de DLFP, c'est la même chose?)
  • c'est l'équipe de Github qui délire complètement?

Que pensez-vous de ce genre de présentation d'un projet, est-ce que vous avez envie de voir plus loin avec ça?

Joyeux vendredimanche!

  • # 100% d'accord...

    Posté par  . Évalué à 10.

    Je te comprends complètement. Ce quoi ce projet qui se donne la peine d'écrire un readme qui se lit en 5 minutes, qui t'explique et tu donnes un aperçu de pourquoi tu voudrais l'utiliser, et qui en plus se permet une touche de légèreté. Tu as complétement raison d'être dégouté. Fermes vite ce projet !

    Autrement ce genre de chose ça existe depuis la nuit des temps il me semble. Effectivement c'est plus ou moins marqué selon les communautés, mais à ce que je sache ça n'a absolument aucun rapport avec la qualité d'un projet.

  • # github

    Posté par  . Évalué à 3.

    En même temps, t'es allé sur github, "le facebook du code", tu t'attendais à quoi d'autre ?

  • # Trouve une femme

    Posté par  . Évalué à 10.

    Trouve une femme (ou un homme selon tes goûts), sors, va prendre l'air. Discute avec des gens, fais du sport.
    Et ensuite tu verras que ce readme ta paraîtra tout de suite moins important. Tu relativiseras, tu diras, bof c'est pas si grave. Personne n'est mort. Et alors tu seras prêt à t'occuper de choses vraiment importante.

    • [^] # Re: Trouve une femme

      Posté par  . Évalué à 4.

      Trouve une femme (ou un homme selon tes goûts)

      Ou plusieurs, ou un animal, ou des animaux, ou un ou des enfants..

      Pourquoi être si restrictif ? :D

      THIS IS JUST A PLACEHOLDER. YOU SHOULD NEVER SEE THIS STRING.

  • # tout a fait d'accord

    Posté par  . Évalué à 10. Dernière modification le 09 décembre 2012 à 20:52.

    Une doc, c'est pas fait pour faire de l'humour. Ca doit être rasoir et chiant comme la mort.

    Merci de dénoncer ce projet délinquant et de venir nous pondre un journal sur ce sujet de première importance.

  • # Ironie ?

    Posté par  . Évalué à 6.

    Nan mais si ça si trouve il faut prendre l'article lui-même pour une blague. On devrait alors lui mettre des plus :P

  • # Planquez vos enfants (ou laissez les se faire achever)

    Posté par  . Évalué à -9.

    C'est Dutroux³ c'est clair. ALERTE GENERALE!

  • # Sugar, spice, and everything nice...

    Posté par  . Évalué à 6.

    … il faudra penser à ajouter accidentellement du "Chemical X", sinon ça marche moins bien: http://www.youtube.com/watch?v=4mmCMUPCNgE

Suivre le flux des commentaires

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