Sanity is Relative
The further away you are from the QA department, the looser the definition of version sanity. By the time you get to the back of the development department, where the newbies sit, the definition of sanity is “compilable”.
Written in collaboration with Efrat Wurzel
Got a new product to test, and the most documentation anyone can provide is an e-mail saying “wouldn’t it be cool if we got drunk and then wrote some code”? 1,134 more words
Two notes before we begin: first, this article is about software how-to videos, not instructional videos that explain a subject or your business plan.
Second, this is the first article of two. 788 more words
Don’t Let Developers Go Crazy With Testing Instructions
When asked to provide testing instructions for a new feature or bug fix, there are three types of developers: some are surgically precise, some are fairly precise while erring towards caution, and some give the widest set of instructions they can get away with, usually in an effort to protect themselves against accusations of insufficient test coverage.
Some technical writers hate FAQs. I rather enjoy them, because they’re the only bit of technical writing most people will ever bother reading. But they’re not always an easy thing to write; since FAQs are never full explanations of the application or website, deciding what to put in them can be difficult.