Re-organise docs examples

[skonik]

Description of Change

Documentation examples are now grouped into subsections per example topic.

Assumptions

Checklist for All Submissions

• I have added change info to CHANGES.rst
• If this is resolving an issue (needed so future developers can determine if change is still necessary and under what conditions) (can be provided via link to issue with these details):
  • Detailed description of issue
  • Alternative methods considered (if any)
  • How issue is being resolved
  • How issue can be reproduced
• If this is providing a new feature (can be provided via link to issue with these details):
  • Detailed description of new feature
  • Why needed
  • Alternatives methods considered (if any)

Checklist when updating botocore and/or aiohttp versions

• I have read and followed CONTRIBUTING.rst
• I have updated test_patches.py where/if appropriate (also check if no changes necessary)
• I have ensured that the awscli/boto3 versions match the updated botocore version

[codecov]

Codecov Report

Merging #810 (4de9936) into master (4d198ec) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #810   +/-   ##
=======================================
  Coverage   89.27%   89.27%           
=======================================
  Files          42       42           
  Lines        4576     4576           
=======================================
  Hits         4085     4085           
  Misses        491      491           

Flag	Coverage Δ
unittests	89.27% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4d198ec...4de9936. Read the comment docs.

[terricain]

Let me know when your finished and i'll look through it

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[thehesiod]

@terrycain is this ok to merge?

[terricain]

Yep looks fine, just a bit of re-organisation it seems

[terricain]

Looks good, but you'll need to rebase the branch to take into account newer changes in master.

[skonik]

Sorry, completely forgot about this.
Yes, this is just a simple re-organisation

[skonik]

Let me fix some typos. In general currently we have this

aiobotocore-reorganize-docs.mov

[thehesiod]

thanks!