better docs, see #354