The website
When I was trying to install linux on every single device with a CPU on my house I stared making tutorials in markdown.
I did those tutorials to make sure I could replicate my instalations and that I didn't make the same mistake twice.
It got to one point where the information I had in them was so detailed that it just wasn't anywhere else on the internet. On that moment I decided that I wanted to share my knolege with the world just like the world shared that knologe with me.
At first I was just thinking of a simple gitlab repo with the md files but on the day I was buying the Ampex the guy asked me if I had a website. And from that day on I started making some light reserch on how to make a website
I started on the most popular way Wordpress. But it was slow, yes it was preety but I had to make so many choices and select so many text boxes and each time I needed an image I needed to import the thing, it was clunky.
It needed to be faster.
I already had a lot of md files and if they can be passed to PDF then there must be a way to parse them to a simple website right?
And the solution to that problem was mkdocs
But of course I didn't want a simple thing I wanted an entire pipeline. I wanted to write the md files in my computer/local repo and in the moment I pushed the code to the remote the website would automaticly update everything without intervention.
In the end this criterion was completly fufflied.
But first.
Getting a local version running
The first part is creating a Venv with mkdocs
python -m venv venv
pip install mkdocs
https://www.mkdocs.org/getting-started/
I also used mkdoc material so I needed to install that as well
https://squidfunk.github.io/mkdocs-material/getting-started/