Maybe Our Documentation "Best Practices" Aren''t Really Best Practices
Kayce Basques, an awesome tech writer on our team wrote up a pretty amazing article about his experiences measuring how well existing documentation best-practices work for explaining technical material. Best practices in this sense can be well-known industry standards for technical writing, or it could be your own companies writing style guide. Check it out! Recently I discovered that a supposed documentation "best practice" may not actually stand up to scrutiny when measured in the wild.