fix ~ docs

closes #11