AREDN Documentation Repository
Go to file
Steve 6ac5aca83e
add intro section (#359)
2024-05-31 11:27:07 -07:00
_images add intro section (#359) 2024-05-31 11:27:07 -07:00
appendix update Known Issues list 2023-04-19 07:20:41 -07:00
arednGettingStarted add link for protocol lists (#358) 2024-05-28 19:40:15 -07:00
arednHow-toGuides update Supernode how-to article (#356) 2024-05-25 06:29:43 -07:00
arednNetworkDesign add supernode info to Network Design Guide (#290) 2023-09-21 15:10:15 -07:00
arednServicesGuide update meshchat release repo links (#342) 2024-03-04 20:07:33 -07:00
.gitignore Add Sphinx Makefile to repo (#104) 2021-03-15 09:55:41 -05:00
.readthedocs.yaml add offline build formats (#325) 2023-12-11 15:51:28 -07:00
How to Use GitHub for AREDN.md Update HowTo MD file with new default branch name (#100) 2021-01-29 13:56:46 -06:00
Makefile Add Sphinx Makefile to repo (#104) 2021-03-15 09:55:41 -05:00
README.md fix links/referrers to external sites (#220) 2022-11-18 09:39:07 -06:00
conf.py add intro section (#359) 2024-05-31 11:27:07 -07:00
index.rst add intro section (#359) 2024-05-31 11:27:07 -07:00
requirements.txt sphinx version (#261) 2023-05-08 16:41:26 -05:00
why_aredn.rst add intro section (#359) 2024-05-31 11:27:07 -07:00

README.md

AREDN Documentation

This repository is for creating documentation for the AREDN project so it can be made available on ReadTheDocs.

Viewing the Docs:

To view the AREDN documentation in a web browser, navigate to https://arednmesh.readthedocs.io/en/latest/ or select your choice from the Docs dropdown menu on https://www.arednmesh.org.

Exporting to PDF:

While viewing the AREDN documentation in your web browser, you will see the contents list in the left panel. At the bottom of the panel is a drawer labeled "ReadTheDocs" showing the version you are viewing. Click the label bar to open it. From the drawer you can export the documentation set as a single PDF or Epub file. This is handy if you want to take a PDF copy of the guidebook with you into the field where you do not have Internet access.

Contributing:

If you are interested in contributing to the rapidly growing set of AREDN related information, you can easily do so on GitHub. The workflow for contributing documentation is described in detail here: How to Use GitHub for AREDN.

AREDN documentation is written using the reStructuredText markup language and your text is saved in "rst" files. Before committing your changes, be sure to test your "rst" files locally using Sphinx to ensure they will render correctly.

Your local code branch name can be anything that makes sense to you. After you create your Pull Request, the AREDN team will review your request just as it does for code changes. Once your documentation contributions are committed to the AREDN GitHub repository, a webhook automatically updates and builds the latest docs for viewing and exporting on ReadTheDocs.org. All contributions that are included by the AREDN® team in the documentation set will be covered by the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International license held by Amateur Radio Emergency Data Network, Inc.