khuedoan-homelab/docs/concepts/documentation.md

35 lines
1.4 KiB
Markdown
Raw Normal View History

2022-07-15 20:28:57 +07:00
# Documentation (this website)
The project uses the [Diátaxis](https://diataxis.fr) technical documentation framework.
It can be viewed at <https://homelab.khuedoan.com>.
2022-07-15 20:28:57 +07:00
## Local development
To edit and view locally, run:
```
make docs
```
Then visit [localhost:8000](http://localhost:8000)
## Deployment
It's running on my other cluster in the [khuedoan/horus](https://github.com/khuedoan/horus) project
(so if the homelab goes down everyone can still read the documentation).
<!-- TODO -->
<!-- This website is running in both my homelab cluster and on my other cluster in the [khuedoan/horus](https://github.com/khuedoan/horus) project (both in `apps/homelab-docs`), -->
<!-- with manual DNS switch over in case I want to rebuild either of them (this is the most cost effective way to do this that I can think of). -->
<!-- You don't have to do this, you can host it on 1 cluster just fine. -->
<!-- But for 0.000000000001% of you who have 2 clusters like me, here's how to switch between them: -->
<!-- - Add the following annotation to the Ingress on the new cluster: `TODO` -->
<!-- - Go to DNS config on Cloudflare dashboard -->
<!-- - Find the TXT record for `homelab.khuedoan.com` and switch the `ownerID` between `homelab` and `horus` -->
<!-- - Wait for the matching CNAME or A record to change -->
<!-- - Check if you can still access the website -->
<!-- - Do what ever you want to do -->
<!-- - (Optional) Switch back to the previous cluster -->