[DOC] fix typos + section on setting doc IDs

Fix #263
[DOC] Fix formatting