Add Category usage to readme.md
Modify shared_examples to be more reusable and update usage.