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

I'd originally created this PR under the wrong repo.