documentation changes for https://github.com/flapjack/flapjack/pull/644