documentation(2/0)

Document your API

Turns out that the UK has great advice for Documenting APIs.

Process maps are tools for change

The clarity of a process map may lead management to believe that an updated flowchart is an excellent tool for on-boarding instruction. “Each step of the process is painstakingly accounted for,” a manager might reason, “so why don’t we give this chart to new hires so they know how to do their jobs?” There’s enough truth in this sentiment to make it attractive to those who aren’t familiar with the process in question, but those who actually perform the work incorporate other influences outside the flowchart’s context.…