doc: use non-contracted forms in written documents
doc: typographical fine tuning
doc: adhere to XML syntax