doc: typos + more explanations