OTOH once you document something you need to do more work when you change the behaviour