Clarifications on writing docs