655619747f
* Doc fixes and restructuring This commit includes several misc changes to doc set. Create appendix directory and add freq section with website images. Expand how-to contribute section. Add reference to new 29 Host LAN mode. Add SNR sound control to SNR graphs section. Add Radio Mobile Settings to How-To section. Update images in Freq Spectrum section, and minimize reference to "unshared" channels. Move Server Sync section to Services Overview. * Fix misleading keyword search wording Fix the misleading wording about doing a keyword search for AREDN. * Fix total bandwidth allocation wording Fix total bandwidth allocation wording in Radio Spectrum section. * Clarify channel width at band edges Clarify the warning against using wide channels that could transmit outside of allowed FCC allocations. * Heading change in services overview * Add balancing comment about reducing channel width Add a balancing comment that reducing channel width to increase SNR also cuts throughput in half. * Add SNR warning comment * Fix reference to OpenWRT in screenshot Replace reference to OpenWRT in screenshot with the AREDN login banner. |
||
|---|---|---|
| _images | ||
| appendix | ||
| arednGettingStarted | ||
| arednHow-toGuides | ||
| arednNetworkDesign | ||
| arednServicesGuide | ||
| .gitignore | ||
| How to Use GitHub for AREDN.md | ||
| README.md | ||
| conf.py | ||
| index.rst | ||
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://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 identical to the workflow for contributing code which is described in detail here: How to Use GitHub for AREDN.
The only difference is the repository name of aredn/documentation and the main branch name of master. 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 updates and builds the latest docs for viewing and exporting on ReadTheDocs.org
AREDN documentation is written using the reStructuredText markup language. Text is saved in "rst" files. Before committing your changes, be sure to test your rst files to ensure they will render correctly.