Update configuration docs

MtnMesh · Oct 19, 2024 · ed6fc7a · ed6fc7a
1 parent 6b492bb
commit ed6fc7a
Show file tree

Hide file tree

Showing 4 changed files with 17 additions and 6 deletions.
diff --git a/docs/config.md b/docs/config.md
@@ -4,6 +4,9 @@ status: new
 
 # Recommended Configuration Settings
 
+In order to maintain a healthy mesh network, we recommend the following configuration settings for your Meshtastic devices.
+
+These settings are intended to facilitate a stable and reliable mesh network. They are based on the collective experience of the Mountain Mesh community and are subject to change as the mesh grows and evolves.
 
 ## Radio configuration
 
@@ -14,7 +17,7 @@ status: new
     |                        Role | `CLIENT` or `CLIENT_MUTE` | See :fontawesome-brands-youtube: [Meshtastic Deployment Scenarios](https://www.youtube.com/watch?v=htjwtnjQkkE) |
     | NodeInfo broadcast interval | `10800` (3 hours)         |                                                                                                                 |
 
-=== "Position"
+=== ":material-map-marker-alert: Position"
 
     |                      Option | Recommended Config   | Notes                                           |
     | --------------------------: | :------------------- | :---------------------------------------------- |
@@ -46,7 +49,11 @@ status: new
 
 === "Neighbor Info"
 
-    |                Option | Recommended Config |
-    | --------------------: | :----------------- |
-    | Neighbor Info enabled | `True`             |
-    |       Update interval | `21600` (6 hours)  |
+    |                Option | Recommended Config | Notes                                                       |
+    | --------------------: | :----------------- | :---------------------------------------------------------- |
+    | Neighbor Info enabled | `True`             | Only enable this on "infrastructure" nodes.                 |
+    |       Update interval | `21600` (6 hours)  | This is a large packet! Do not set this lower than 6 hours. |
+
+    Neighbor Info is a large packet and should only be enabled on "infrastructure" nodes (Routers / Home base-stations). This is a great way to see who is around you on our mapping tools, but it is not recommended for mobile nodes or secondary indoor nodes.
+
+    Setting the interval too low will cause congestion on the mesh, leading to packet loss and dropped messages.
diff --git a/docs/neighbors.md b/docs/neighbors.md
@@ -11,3 +11,7 @@
 
 - Austin, Texas: [Austin Mesh](https://www.austinmesh.org/)
 - Sacramento, California: [Sac Valley Mesh](https://www.sacvalleymesh.com/)
+
+## Related groups
+
+- DefCon Atlanta: [DC404](https://dc404.org/)
diff --git a/docs/static/meshinfo_map.png b/docs/static/meshinfo_map.png
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -1,6 +1,6 @@
 site_name: MtnMe.sh
 site_author: MtnMe.sh
-site_description: "Mountain Mesh: Serving Meshtastic to the Appalachian Mountains (North GA)"
+site_description: "Mountain Mesh: Serving Meshtastic to the Appalachian Mountains (North GA / East TN)"
 copyright: © Creative Commons Attribution-ShareAlike 4.0 International License
 site_url: https://mtnme.sh/
 repo_url: https://github.com/MtnMesh/mtnmesh.github.io