Recent searches
Search options
Administered by:
Technology should be human-scale. This doesn't mean the average person has to understand it., It means the average person has a *path* to understanding it.
Currently most documentation is poor or already expects a certain level of understanding.
I should be able to ask "How does my system manage audio?" and be guided through a giant yak-shaving exercise without any former knowledge of audio systems
Can we document software that well?
@josias The development is going "forward" for the sake of having a "backward". Isn't that the issue – documentation is typically short–term?
I understand you seek a whole stack system, that includes code, documentation, learning material to be able to understand, and improve a system end-to-end.
That is good thinking, but it will not happen in the realm of the industry.
And that is because of how the world works: competition.
Every country, every company, and most people behind those want to have an edge to win big.