Improve documentation to avoid mistakes such #19