* document per namespace params * switch examples to codenew, fixup some typos * more formatting and codenew * use codenew instead of code * fixup headings