Hacker News new | past | comments | ask | show | jobs | submit login

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.




That'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.


I 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.




Join us for AI Startup School this June 16-17 in San Francisco!

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: