That devs in FOSS projects are 1st-class citizens and doc writers are 2nd/3rd has been so pervasive for so long, that I *still* I dismiss my almost 20yrs of writing and only treat my relatively small code as my "real" contribution. Glad to see some communities trying to fix this.

Follow

@kyle This is true even in languages that are considered at a higher level of abstraction. i.e., closer to human language or clearer in describing the problem solution. Leon Starr does a very good job of explaining why good documentation is important in his book, Executable UML: How to Build Class Models. He also stresses how important it is to preserve even the little pictures that you might draw to help yourself understand the problem. Documenting assumptions is very important.

Sign in to participate in the conversation
Librem Social

Librem Social is an opt-in public network. Messages are shared under Creative Commons BY-SA 4.0 license terms. Policy.

Stay safe. Please abide by our code of conduct.

(Source code)

image/svg+xml Librem Chat image/svg+xml