WIP Cartridge Refactor - Update cartridge author's guide

* latest updates/improvements
Merge pull request #1460 from jwhonce/wip/master

WIP Cartridge Refactor - Update cartridge author's guide