Doc updates

more DOC todos
updated docs to use <pre> blocks around code to make it easier to read.