API doc examples, doc in general, tiny refactorings