mirror of
https://github.com/meshtastic/meshtastic.git
synced 2024-11-15 18:14:19 -08:00
69 lines
4.5 KiB
Plaintext
69 lines
4.5 KiB
Plaintext
---
|
|
id: docs
|
|
title: Maintaining Documentation
|
|
slug: /development/docs
|
|
sidebar_label: Docs
|
|
sidebar_position: 9
|
|
---
|
|
|
|
Meshtastic documentation is an important ingredient to the overall project. We want users to hit the ground running with the information they need right at their finger tips. This section will discuss the documentation software stack, file organization, and style guides.
|
|
|
|
## Software Stack
|
|
|
|
All of our documentation resides on GitHub. Instructions for setting up your GitHub account are located [here](/docs/development/reference/github).
|
|
|
|
Our documentation is powered by [Docusaurus](https://docusaurus.io) — a documentation platform built on React that utilizes markdown files. Because markdown files are easy to edit, most content changes should be fairly simple.
|
|
|
|
Another component that we use is [Vercel](https://vercel.com) — a platform for front-end frameworks and static sites. Instructions for setting up your instance of Vercel are located [here](/docs/development/documentation/publish#publish-to-vercel).
|
|
|
|
## Documentation Organization
|
|
|
|
| Section | File Path | Description |
|
|
| :----------------------: | :---------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|
|
| About Meshtastic | `docs/about` | A high level explanation of Meshtastic plus everything relating to the Meshtastic mesh. This includes radio settings, mesh algorithm and encryption. |
|
|
| Getting Started | `docs/getting-started` | Instructions on how to get the Meshtastic firmware onto a users device. |
|
|
| Device Settings | `docs/settings` | Details each user setting and provides explanations for what the setting does and how to configure the device using the various clients available (Android, CLI, iOS, Web) |
|
|
| Hardware Details | `docs/hardware` | Any hardware related content. Any time a user is attaching a peripheral accessory to their device. That includes 3D printed cases, antennas, buttons, chimes, rotary encoders, and screens. |
|
|
| Meshtastic Software | `docs/software` | Current bulk of documentation running through each Meshtastic project. |
|
|
| Contribute to Meshtastic | `docs/developers` | Details each of the projects and how they work together to give a developer an idea of how the Meshtastic ecosystem operates. |
|
|
| Legal | `docs/legal` | Any legal information. Most changes here will be handled by developers actually working on the projects that require any legal disclosures. Examples include: the Meshtastic trademark, terms of service, and privacy policy. |
|
|
|
|
## Quick Start
|
|
|
|
Assuming you have the [prerequisites installed](/docs/development/documentation/local-dev#prerequisites), running a local instance of Docusaurus takes three steps:
|
|
|
|
1. Fork/Clone the [meshtastic/meshtastic](https://github.com/meshtastic/meshtastic) repository and navigate to the root directory of the project.
|
|
|
|
```shell title="Clone the project"
|
|
git clone https://github.com/meshtastic/meshtastic.git
|
|
```
|
|
|
|
```shell title="Clone fork of the project"
|
|
git clone https://github.com/[username]/meshtastic.git
|
|
```
|
|
|
|
```shell title="Change Directory"
|
|
cd ~/Meshtastic
|
|
```
|
|
|
|
2. Install Dependencies
|
|
|
|
```shell title="Install dependencies using Yarn"
|
|
yarn install
|
|
```
|
|
|
|
3. Run Docusaurus
|
|
|
|
```shell title="Run node.js server"
|
|
yarn start
|
|
```
|
|
|
|
:::tip
|
|
Before submitting a pull request, it's helpful to run the following command to ensure there are no broken links or errors:
|
|
|
|
```shell title="Build Project"
|
|
yarn build
|
|
```
|
|
|
|
:::
|