docs: add docs editing procedure+guidelines

add FUNDING.yml
2025-04-08 16:19:37 -04:00 · 2025-04-07 19:21:22 -04:00
4 changed files with 54 additions and 2 deletions
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@ -0,0 +1,13 @@
+github: ihatenodejs
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@ -10,4 +10,5 @@
 * Reference

    * [Environment Variables](reference/env.md)
-    * [Database Migration Guide](reference/db-migration.md)
+    * [Database Migration Guide](reference/db-migration.md)
+    * [Editing Documentation](reference/editing-docs.md)
--- a/docs/index.html
+++ b/docs/index.html
@ -2,7 +2,7 @@
 <html lang="en">
 <head>
  <meta charset="UTF-8">
-  <title>Document</title>
+  <title>LibreCloud Docs</title>
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
  <meta name="description" content="Description">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
--- a/docs/reference/editing-docs.md
+++ b/docs/reference/editing-docs.md
@ -0,0 +1,38 @@
+# Editing Documentation
+
+You can freely modify the LibreCloud documentation on our [repository](https://git.pontusmail.org/librecloud/web), in the `docs/` folder. We encourage contributions of all kinds!
+
+## Editing Guidelines
+
+- Have common sense, please.
+- Obviously, this is not the place to rant about your political beliefs or spread hate.
+- Test the instructions/docs you write, if possible.
+- Yeah, just have common sense
+
+Just be sure to link your new pages in `docs/_sidebar.md` so people can find them!
+
+## Serving Docs
+
+You might want to serve the docs you've edited to see how they'll look on [docs.librecloud.cc](https://docs.librecloud.cc). No fear, Docsify is here!
+
+Do this with the `docsify-cli`, which can be installed like so:
+
+**Bun**
+
+```bash
+# This will be installed globally
+bun i docsify-cli -g
+```
+
+**NPM**
+
+```bash
+# This will be installed globally
+npm i docsify-cli -g
+```
+
+Finally, you can serve the docs with this command:
+
+```bash
+docsify serve docs
+```
Author	SHA1	Message	Date
Aidan	49e3833756	docs: add docs editing procedure+guidelines	2025-04-08 16:19:37 -04:00
Aidan	55d441c926	add FUNDING.yml	2025-04-07 19:21:22 -04:00