initial port of guide to markdown format, including changes to match current appliance behavior