MkDocs is a popular tool in the Python ecosystem to generate
documentation. It has support for parsing Python docstrings in order to
generate API documentation quite easily.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

The emoji extensions have been incorporated directly into
mkdocs-material.

Signed-off-by: JP-Ellis <josh@jpellis.me>

The scripts are significantly improved to make them easier to use and
maintain.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

The main README has been completely overhauled:

- It is now more closely aligned with Pact JS and Pact Go
- It is much shorter, with usage documentation having been moved into
  `/docs`
- Reference to Pact Python `v3` has been added.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

This is a major write up of docs for V3. Including the following
changes:

- Adding a timeline to make it clearly visible
- Added usage documentation within the modules
- Consolidated all `Interaction` classes into one module, and hiding the
  sub-modules from the docs.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>

Fix typos

Authored-By: JosephBJoyce
Cherry-Picked-By: JP-Ellis <josh@jpellis.me>

Due to the processing that is done on files outside of `docs/`, links to
file _inside_ the `docs/` directory do not work.

This adds a hook to MkDocs which rewrites these links.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Specifically, adding `FORCE_COLOR` to ensure we have coloured output (it
is prettier afterall), and making sure `HATCH_VERBOSE` is always enabled
in case there's an error.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Signed-off-by: JP-Ellis <josh@jpellis.me>