Documentation

In interacting with a domain registrar this morning I received a message that looked approximately like: A few things come to mind: 1. This code is 27 characters long. The longer the code the more chance you have of someone improperly copying it, or not being able to read it over the phone. This applies both to the customer and to the support staff. This code has 62^27 combinations, which seems like overkill. An eight character code using only uppercase letters would be sufficient for 208 billion combinations (26^8), and is way more usable to us humans. 2. This code mixes uppercase and lowercase. Uppercase is often more readable, and support staff can always assume that when a customer says …

Read More

Documentation is often dull and drab, optimized for getting information to those in need as efficiently as possible. Yet once in a while there’s something that makes dorks like myself chuckle. Like fun example data in the Atlassian Confluence documentation: The characters are from Fight Club, if you aren’t familiar with the movie. Nothing says you can’t entertain while you’re informing, even if it is just movie character names.