docs: closes #896