It should have been documented here, but it’s not, we need to fix that. We should also have an equivalent documentation for snapcraft.yaml, which is very similar but not quite the same thing.
@degville Can you please have a look into these two issues when you have a moment?
We’re overhauling the documentation format and location, so some of that will take a little while to get back into snapcraft.io.