> You often see a whole chapter in the beginning devoted to explaining the philosophy behind the technology, rather than letting the user get a feel for the philosophy themselves, by doing.
I agree that this is annoying. As an author, it's very tempting, since you want to explain why your solution is better than all the other solutions that came before. But the vast majority of readers won't know anything about the other solutions and just want to know what your thing does. The "Avail" language page posted yesterday [1] was a perfect example.
I agree that this is annoying. As an author, it's very tempting, since you want to explain why your solution is better than all the other solutions that came before. But the vast majority of readers won't know anything about the other solutions and just want to know what your thing does. The "Avail" language page posted yesterday [1] was a perfect example.
[1] https://news.ycombinator.com/item?id=17150346