yeti@lemmy.dbzer0.com to Programmer Humor@lemmy.ml · 1 year agoDiscord != Documentationlemmy.dbzer0.comimagemessage-square145fedilinkarrow-up11.09Karrow-down111cross-posted to: [email protected]
arrow-up11.08Karrow-down1imageDiscord != Documentationlemmy.dbzer0.comyeti@lemmy.dbzer0.com to Programmer Humor@lemmy.ml · 1 year agomessage-square145fedilinkcross-posted to: [email protected]
minus-squareOsrsNeedsF2P@lemmy.mllinkfedilinkarrow-up61·1 year agoIt wastes everyone’s time. The project maintainers have to keep answering the same questions, and the users don’t have instant access to answers
minus-squareSokathHisEyesOpen@lemmy.mllinkfedilinkarrow-up23·1 year agoWhy would any sane developer want to use this system to “document” their project? Written docs have worked well for a million years and there’s no need to change them.
minus-squareFreeman@lemmy.publinkfedilinkarrow-up16·1 year agoYou can even include them in your version control system and allow others to suggest changes
minus-squareSokathHisEyesOpen@lemmy.mllinkfedilinkarrow-up11arrow-down1·1 year agoAnd you can include separate ones right there in the root folder where the script lives. README.md renders out beautifully on GitHub.
It wastes everyone’s time. The project maintainers have to keep answering the same questions, and the users don’t have instant access to answers
Why would any sane developer want to use this system to “document” their project? Written docs have worked well for a million years and there’s no need to change them.
You can even include them in your version control system and allow others to suggest changes
And you can include separate ones right there in the root folder where the script lives. README.md renders out beautifully on GitHub.