* add new documentation guidelines * add new guidelines with additional details * fix minor formatting issue * update admonition examples * make minor updates for the use of single ticks * add proofreading fixes