Documentation is a Product - Adam Wathan (Tailwind CSS)
Developer Experience
00:00
The Importance of Execution in a Framework
Trying to show as much context as possible and code samples one thing I hate when I'm reading documentation is when they've stripped out everything except the exact thing that they're trying to show you so often I'm left wondering what file is this even in where am I supposed to do this. We always make sure to show the file name whenever possible or an example file name like tailwind.config.js which might be obvious but at least it's there. Even if we just want to focus on some small area of the code but it's more clear what you should actually be doing with the surrounding context will dim the surrounding code and highlight just the thing that you're supposed to look at
Play episode from 20:51
Transcript
