fix #101 by documenting it