clean up docs

puppet doc output was nearly illegible. this cleans up the docs quite a
bit.