As discussed in #197, this renames the `reqs` argument to `Site`
to `connection_options`. The old name still works but triggers a
DeprecationWarning. If you specify both we raise ValueError.

Signed-off-by: Adam Williamson <awilliam@redhat.com>

Signed-off-by: Adam Williamson <awilliam@redhat.com>

This is based on
https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/#defining-a-workflow-job-environment
. It's the sample config from there, with versions updated and
our project name substituted in the appropriate places. I dropped
the publish-to-testpypi bit because of
https://github.com/pypa/packaging.python.org/issues/804

 , and left
the Github release part left out for now. We can add that later if
we like, but we never published releases to Github before, so it
doesn't seem required yet. I also tweaked the conditionals a bit
to avoid running the build job on forks and publish only tags
that start with 'v', as that's our convention for versions.

Signed-off-by: Adam Williamson <awilliam@redhat.com>

It's much nicer to have the main repo as origin and your fork as
another remote you just push PR branches to. That way you don't
have to deal with resyncing the master branch of your fork all
the time.

Signed-off-by: Adam Williamson <awilliam@redhat.com>

- Move the auth anchor to be above the correct section
- Add missing anchors so all sections have them
- Add blank line above the old_login anchor and use hyphen instead of _.

This fixes the warning:

DeprecationWarning: Specifying host as a tuple is deprecated as of mwclient 0.10.0. Please use the new scheme argument instead.

Per #223

Use and recommend format from RFC 7231.
Give examples for custom User-Agent strings.

Closes #49

Per #223

We switched to pycodestyle then flake8 recently, but one stray
reference to pep8 was left in this doc file.

Signed-off-by: Adam Williamson <awilliam@redhat.com>

somtimes -> sometimes
if do -> if you do

This is what is imported at the beginning of the examples.
This could also be done by changing the import to 'import mwclient'
rather than 'from mwclient import Site'.

Neither seems more correct but I have tried to follow
what seems most intended.

>>> from mwclient import Site
>>> site = mwclient.Site('en.wikipedia.org')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'mwclient' is not defined

vs.

>>> site = Site('en.wikipedia.org')
>>> page = site.pages['Greater guinea pig']
>>> text = page.text()
>>> page.exists
True

PR #136 fixes #88

- https is standard now, so no need to explicitly declare that
- wrap lines around 90 chars
- minor rewriting

to adher to 52b9d8b8

Remove python2.6 from
- Travis
- Tox
- PyPi tags
- documentation and readme

Also, Simplify an import clause.

This fixes #133

- Adds link to the user guide from readme
- Adds a new page to the user guide on "working with files"

Add OAuth and update docs

- Remove :ref:s from the headers, since they made the latex build crash
- Add logo

Remaining issue:

- Can't get headings levels right on both the html and the latex builds
  at the same time. More info in #40