reorganize docs into folders, fix links

[patricksurry]

Reorganizes docs into folders following the getting started guide, fixing various broken links.

I also included an environment.yml and mkdocs.yml for local testing and link checking via mkdocs + mkdocs-material:

micromamba create -f environment.yml
mkdocs serve

then browse at http://127.0.0.1:8000/en/

It looks pretty good with almost no config and has language selector plus search for free 🔥 But these changes should also be fine with the existing website.

[claycooper]

Thanks for your work here. I'm going through what publishing the pages might look like and have started a conversation with the other reviewers about the direction for documentation.

[patricksurry]

i'm far from an expert, but github pages might even be viable for the docs pages themselves, and just link from the website? i've used that with mkdocs before.

[claycooper]

I tried running the commands provided without success. I'm not familiar with micromamba and Google is not being a friend with that error.

warning  libmamba No 'channels' specified
error    libmamba Could not solve for environment specs
    The following packages are incompatible
    ├─ pip does not exist (perhaps a typo or a missing channel);
    └─ python does not exist (perhaps a typo or a missing channel).
critical libmamba Could not solve for environment specs

[patricksurry]

I think it's this issue. Try micromamba config --add channels conda-forge

[claycooper]

We've removed the non-English versions of the docs in #933 . Can you re-base to include those changes and other updates to docs that have happened over time? I'm also working on getting a theme closer to the current site's main color and adding a favicon and can push those to this PR. If you want to attempt that before I get to it, then go ahead.

[claycooper]

Because of access issues and wanting to preserve existing document pathing I've taken your work over to the kmk_website repository and pushed an initial version to the website. Thank you for getting this work started.