When it comes to API & docs, would something like this not be better to have & do?
@sitter @dfaure @meven