fix #91 by documenting this better