Hacking the English Language
A good doc is like a good program: beautifully architected, free of clutter, and easy for others to understand and maintain. In this session we’ll explore a programmatic approach to writing conceptual content, including the application of design patterns to writing, principles of good doc structure (architecture), and the importance of word choice and clarity (naming your variables).
We’ll review “code samples” - examples of real sentences from docs - and refactor them into clear, straightforward explanations that help the reader learn. Throughout the talk, we’ll introduce a new way for developers to think about writing and for writers to think about the technology we are documenting.