Documentation comes in many forms. If you want a great article about documentation go back to the very first issue of this newsletter. Once I have learned how something works the best way for me to understand how to use it is with examples.
This week I’ve been building something without any example code. There is a high level spec, an example (full) implementation, but no simple examples. It has taken me much longer than I expected to reverse engineer my use case without any examples.