refactored viz documentation substantially; changed to markdown, inlined snippets, etc.