doc: test-writing-guidelines: Fixes

* Add a paragraph about one record per test in runtest files

* Fix typos, clarify a few places

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>