Call factory only if the kw was really missing
Annotate examples in docs
Minor polishing