Documentation Updates

[phil-6]

Pull Request

Summary:
Updates the docs to add new information from discussions

Description:
Simple changes to improve readability (mostly adding line-breaks)
Extra information around upgrading and new approaches.

Testing:
Only Changes to Docs

Checklist:

• [ x ] Code follows the project's coding standards
• [ x ] Tests have been added or updated to cover the changes
• [ x ] Documentation has been updated (if applicable)
• [ x ] All existing tests pass
• [ x ] Conforms to the contributing guidelines

[excid3]

Couple small tweaks I made:

1. cert_path should be under iOS
2. Adjusted the to_prepare example to add a belongs_to :organisation and simplify it a bit.

[excid3]

Also showed that you can extend Noticed::Event as well.

[phil-6]

Amazing, Thanks Chris! I was just about to add a note about Noticed::Event!