commit 883d40c929216558cac774007b9570075372f577
parent 5c82d9d5fc5692d444c3768b16138b5e9ef01059
Author: AndrewLockVI <andrew@laack.co>
Date: Mon, 10 Feb 2025 11:19:51 -0600
Updated formatting with headings for SH
Diffstat:
2 files changed, 4 insertions(+), 6 deletions(-)
diff --git a/docs/DocumentationHosting.md b/docs/DocumentationHosting.md
@@ -2,7 +2,7 @@
Documentation hosting is important and depending on ones needs, different solutions may be optimal.
-##### SSGs
+## SSGs
Static site generators are a dime a dozen, and they are great from a performance perspective and easy to maintain. I will not go into the specifics of each one but some popular one are Jekyll, Hugo, and Mkdocs. This approach for documentation hosting has pros and cons, as shown below.
@@ -21,7 +21,7 @@ From the perspective of a developer, SSGs are my preferred approach to documenta
The main con of SSGs is they are difficult for non-technical users to change. Given that they are often versioned with git and created by writing markdown files, non-technical users will likely not have a pleasant time trying to make documentation changes which is where wikis come into play.
-##### Wikis
+## Wikis
Wikis are great when non-technical people need to make changes to shared documents or in cases where a web UI for editing documents is mandatory.
diff --git a/docs/FileHosting.md b/docs/FileHosting.md
@@ -2,9 +2,7 @@
There are many file hosting implementations, and they differ in slight ways. Below are a list of them and my general findings about each implementation.
-#### Implementations
-
-##### Nextcloud
+## Nextcloud
Nextcloud is a popular choice for file hosting and it works great for a lot of people. Below are some pros and cons to the service.
@@ -29,7 +27,7 @@ It is often noted by Nextcloud users that migrating to newer versions is difficu
The main dealbreaker for many is the performance of Nextcloud. Even with Redis caching and a dedicated database (not SQLite), the web UI feels quite slow. With that said, one is hard pressed to find an alternative to Nextcloud that has the ability to easily integrate video conferencing, collaborative document editing, and authentication all in one.
-##### Dufs
+## Dufs
Dufs is a simple rust based file sharing site. Listed below are pros and cons for the service.
