Documentation refactor + nitpicky + example review + chaos

[nabobalis]

Aim to add more info about using aiapy and reduce any overlap with the sunpy development documentation.

TODO:

• [ ] Work out what could be missing and fix it.

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 71.71053% with 43 lines in your changes are missing coverage. Please review.

Project coverage is 87.09%. Comparing base (f92240a) to head (2a1011f).

Files	Patch %	Lines
aiapy/data/_sample.py	13.33%	26 Missing :warning:
aiapy/data/sample.py	70.58%	5 Missing :warning:
aiapy/conftest.py	80.00%	4 Missing :warning:
aiapy/response/tests/test_channel.py	40.00%	3 Missing :warning:
aiapy/util/decorators.py	60.00%	2 Missing :warning:
aiapy/calibrate/transform.py	50.00%	1 Missing :warning:
aiapy/psf/deconvolve.py	50.00%	1 Missing :warning:
aiapy/version.py	80.00%	1 Missing :warning:

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #318 +/- ## ========================================== - Coverage 91.03% 87.09% -3.94% ========================================== Files 35 34 -1 Lines 1193 1209 +16 ========================================== - Hits 1086 1053 -33 - Misses 107 156 +49 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[nabobalis]

This PR got really out of hand.