Set up mkdocs site in PD

[fyliu]

Overview

We need to convert our docs to use the mkdocs documentation generator. It will make it easier to work on documentation. This issue should be done as simply as possible without adding the bells and whistles.

Action Items

• [x] use mkdocs from hackforla project
• [x] customize setting to PD
• [x] set up gh-workflow to update gh-pages on git push
• [x] write documentation on how we set up and use mkdocs
• [x] release #167 from ice box
• [x] check and release #164 from ice box
• [x] take #182 out of the ice box if this is the last dependency

Resources/Instructions

• References for documentation structure;
  • old PD sphinx site
  • black docs
• website-wiki's resources on setting up mkdocs
• Vanessa Rodriguez (gh: vraer) is the person working on the website's wiki mkdocs site. We can ask her about mkdocs.

[fyliu]

I've actually been working on this one and I created a docker config to build an image so our devs won't have to install mkdocs on their own machines. But I realized it can work for all the other teams using mkdocs at hfla, so I went to set up the docker-mkdocs repo for that purpose. I'm planning to finish that soon and then make our setup just download that image rather than build it ourselves.

This should be very fast once I come back to it.

[Neecolaa]

• This is interdependent on https://github.com/hackforla/docker-mkdocs/issues/1 Check there for updates

[fyliu]

I've been working on this and the current progress is this: https://fyliu.github.io/peopledepot/tools/mkdocs/

I also accidentally pushed the changes to hackforla/main for a short time before reverting that history. So the same docs are also hosted at https://hackforla.github.io/peopledepot/tools/mkdocs/