3 ms·
I think that is a dogma future software developers seriously need to reconsider. Naturally, you are free to impose whichever dogmas you believe in for your own
by madsbuch 3y ago
I think that is a dogma future software developers seriously need to reconsider. Naturally, you are free to impose whichever dogmas you believe in for your own code bases.
- otterley 3y agoWhy do you believe it to be a bad rule?
- madsbuch 3y agoI don't know if it is a bad rule. I am just questioning the return of investment on human written documentation. From my perspective, it seems to have diminishing value as we are getting other means of disseminating software documentation.
- otterley 3y agoAre you seriously questioning whether there are significant productivity improvements and customer satisfaction gains associated with having timely and accurate documentation? Also, how do you disseminate documentation that does not a priori exist? It doesn't come out of thin air.
- madsbuch 3y agoI am seriously questioning a lot of things, and so should you. As some of your sibling commenters have also pointed out, my proposal is just that some types of documentation is becoming obsolete. Ie. LLMs will probably rely heavily on tutorials and less structured documentation to explain how certain functions work, in what case we don't have to write that out.