smaller canonicals
update comparisons
split up docs

closes #6