[DOC] add/clarify documentation