initial port of guide to markdown format, including changes to match cur...

...rent appliance behavior