3 ms·
I don’t think any English language based documentation can achieve this: > give the project documentation to three different programmers and receive the exact
by quickthrower2 4y ago
I don’t think any English language based documentation can achieve this:
> give the project documentation to three different programmers and receive the exact same product from all three.
Nit unless the language used is very code-like and pedantically logical to the nth degree.
- pclmulqdq 4y agoThat's not what documentation is for. That's not even really achievable by sharing code unless you are sharing a lot of metadata too (exact build setups, compute environments, etc.) or the code is very simple. Documentation is there to _abstract away_ all of the specification that you don't need. That is very valuable if you are ever going to work with other people - it reduces their cognitive load - and it is valuable if you are working on something complex since it also reduces your cognitive load.
- quickthrower2 4y agoI agree with you, I just don't think this is possible with any kind of documentation in the classic sense: > give the project documentation to three different programmers and receive the exact same product from all three. Is like giving a play script to 3 performers, and expecting the same performance. Software development is a creative art. People will deny it but it is true.