doc tweaks, markup truncation