Update docs: more details on writing tests, sentences on new lines for easier reading offline