change the format to include comments
less obtrucive commenting structure in doc formats
move doc brnach into main mode