docs: moving docs to pages

[npalm]

The documentation in our README have become quite extensive over the years. This PR is moving docs including examples and modules to a documentation site. The top-level readme is shrinked down to some basic / essential information.

• New top-level readme: https://github.com/philips-labs/terraform-aws-github-runner/tree/npalm/mkdocs?tab=readme-ov-file
• Documentation site: https://philips-labs.github.io/terraform-aws-github-runner

For examples and module documentation sources in example and module directories are linked.

[sdarwin]

the reorganization is looking very nice. when possible it's probably better not to hard-code full URLs such as "https://philips-labs.github.io/terraform-aws-github-runner/modules/public/ami-housekeeper/" if documentation is referring to itself it could use a relative path.

[sdarwin]

Minor spelling issue: Introduciton -> Introduction

For each page of text if you quickly copy-paste it into Gmail, that has a built-in spell checker and will suggest what should be fixed.

At least with paragraphs of written content. Maybe it skips formatted YAML documents, and so won't catch everything.

[npalm]

the reorganization is looking very nice. when possible it's probably better not to hard-code full URLs such as "https://philips-labs.github.io/terraform-aws-github-runner/modules/public/ami-housekeeper/" if documentation is referring to itself it could use a relative path.

would be much better, but it is hard to link from both the docs side and the readme's correctly.

[Brend-Smits]

Minor changes, this is a welcoming change.

[npalm]

Pages branch set to gh-pages