teetrinkertoGeneral Programming Discussion•To the brain, reading computer code is not the same as reading language
2·
4 years agoExcluding code / separating code away from the documentation, doesn’t seem like a good idea to me. Code is much more concrete and unambiguous than normal language and I really want clarity and certainty from docs. Maybe for general overview and higher concepts code is not the way to go, but I think that is exactly how good documentation is written already.
But if you have an example of what you would envision docs to be like without (or separated) code then I’d be curious to have a look. Right now, it seems like that would be like the quick coding ideas I write to colleagues sometimes and ask for their opinions. Generally they are uncertain and ask for a concrete code example :)
Codidact is very much a clone of stackoverflow with some tweaks.
Made by some of the moderators and users who left stackoverflow after the whole Monica Cellio incident in 2019