fix multi-level bullet list
rewrite part of template doc

the merge did not work well, plus the previous page was
unfinished. While this edit does not result in great doc,
things have considerably improved -- but work on this page
should continue in the future.