Revise and update documentation, error messages, etc.

[waseem-medhat]

Recently we've done a few updates to both the mix task spirit.gen and to our development/contribution workflow. So we should update the relevant docs and messages to reflect these.