Major docs revamp

Closes #21 and #23

See merge request !78

this commit restructures the docs and revamps the content,
providing a lot more detail on things like auth and
the command-line interface

Update default token scope

Closes #24

See merge request !77

closes #24

Finalise release: 1.1.2

See merge request !76

Update igwn-auth-utils requirement

Closes #22

See merge request !75

as of 0.3.0 igwn-auth-utils no longer has a `[requests]` extra, closes #22

remove manually specified requests extra packages from deb/rpm files

Finalise release: 1.1.1

See merge request !74

Update to not reference HTTPConnection

Closes #20

See merge request !73

Fix bugs in old HTTP API

Closes #19

See merge request !72

Finalise release: 1.1.0

See merge request !71

Handle port numbers in default token_audience

See merge request computing/gwdatafind/client!70

add default audiences with and without the port suffix

Set defaults for token claims

See merge request !61

Add support for request keywords in gwdatafind.ui

See merge request !56

to enable passing arbitrary keywords down to requests.get

Fix docstring issues

See merge request !68

Improvements to code quality analysis in CI

See merge request !69

it comes pre-seeded with dpkg-dev and devscripts, so runs much faster

but make sure and review the code quality report!

and ignore missing docstrings for magic methods

add trailing periods for docstring summaries

Replace complicated quality checks with flake8

See merge request !67