Mais j'imagine l'équivalent d'une page de manuel comme celle de ls, ce serait un peu indigeste , non ?
Je ne sais pas, ça serait à explorer, j'attends d'avoir un bon use case!
J'ai fait un embryon de ce que ça pourrait être avec le début de test de rpl qui se trouve dans les exemples.
Je ne l'ai fait que pour une option, mais il me semble que ça pourrait s'étendre à plus.
Je suis d'accord que les Given/When/Then sont un peu lourd dans une doc utilisateur.
Ça ne dispensera pas de faire plus tard un truc court pour tdlr, de faire une man page, une faq, un guide utilisateur, etc.
Mais dans un premier temps, le rapport temps passé pour avoir une doc quand même lisible et les tests qui vont avec me parait imbattable. Et pour plein de projet il n'y aura jamais besoin d'aller plus loin.
[^] # Re: J'ai compris mais j'ai pas compris
Posté par Lionel Draghi (site web personnel) . En réponse au journal Documenter ou tester, il faut trancher (j'ai pas trouvé de rime avec choisir...). Évalué à 2.
Je ne sais pas, ça serait à explorer, j'attends d'avoir un bon use case!
J'ai fait un embryon de ce que ça pourrait être avec le début de test de
rplqui se trouve dans les exemples.Je ne l'ai fait que pour une option, mais il me semble que ça pourrait s'étendre à plus.
Je suis d'accord que les Given/When/Then sont un peu lourd dans une doc utilisateur.
Ça ne dispensera pas de faire plus tard un truc court pour tdlr, de faire une man page, une faq, un guide utilisateur, etc.
Mais dans un premier temps, le rapport temps passé pour avoir une doc quand même lisible et les tests qui vont avec me parait imbattable. Et pour plein de projet il n'y aura jamais besoin d'aller plus loin.