markup fixes within documentation