Documentation becomes superfluous at the limit since eventually you'll have to read the code. With this in mind, I echo earlier sentiments of brevity, REPL-fri

Documentation becomes superfluous at the limit since eventually you'll have to read the code. With this in mind, I echo earlier sentiments of brevity, REPL-friendly examples, and empathy, but above all BREVITY since greater detail is either outdated or as cognitively demanding as reading the actual code.