Add composer docs command and clarify documentation regeneration instructions

[04cb]

Fixes #788. Adds a convenient composer docs command to composer.json and updates CONTRIBUTING.md to explain when and why documentation needs to be regenerated and committed.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}