From 5b1dfc6da3a76ab1635e579c0374ab71ece5263c Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 31 Jan 2022 09:33:02 -0700 Subject: [PATCH 1/2] created about-documentation section --- docs/about-documentation/overview.md | 6 ++++++ docusaurus.config.js | 3 --- sidebars.js | 5 +++++ 3 files changed, 11 insertions(+), 3 deletions(-) create mode 100644 docs/about-documentation/overview.md diff --git a/docs/about-documentation/overview.md b/docs/about-documentation/overview.md new file mode 100644 index 00000000..4cb9ec99 --- /dev/null +++ b/docs/about-documentation/overview.md @@ -0,0 +1,6 @@ +--- +id: overview +title: Overview +sidebar_label: Overview +slug: /about-documentation +--- diff --git a/docusaurus.config.js b/docusaurus.config.js index 008ff2d4..bea49df2 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -57,13 +57,10 @@ const config = { label: "Contribute to Meshtastic", to: "docs/developers", }, - /* - TODO add Docusaurus and Vercel instructions for how to manage the docs { label: "About this Documentation", to: "docs/about-documentation", }, - */ { label: "Legal", to: "docs/legal", diff --git a/sidebars.js b/sidebars.js index 36af3167..5d6673b2 100644 --- a/sidebars.js +++ b/sidebars.js @@ -192,6 +192,11 @@ module.exports = { }, ], }, + Documentation: { + "About Documentation": [ + "about-documentation/overview", + ] + }, Legal: { Legal: [ "legal/overview", From 3587223fe0410535d83148f46779a18ad5307dca Mon Sep 17 00:00:00 2001 From: Foster Irwin Date: Mon, 31 Jan 2022 10:09:37 -0700 Subject: [PATCH 2/2] added local docusaurus docs --- docs/about-documentation/overview.md | 18 ++++++++ .../about-documentation/serve-docs-locally.md | 42 +++++++++++++++++++ sidebars.js | 1 + 3 files changed, 61 insertions(+) create mode 100644 docs/about-documentation/serve-docs-locally.md diff --git a/docs/about-documentation/overview.md b/docs/about-documentation/overview.md index 4cb9ec99..72f271d0 100644 --- a/docs/about-documentation/overview.md +++ b/docs/about-documentation/overview.md @@ -4,3 +4,21 @@ title: Overview sidebar_label: Overview slug: /about-documentation --- +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 +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 frontend frameworks and static sites. + +## Documentation Organization +| Section | File Path | Description | +| :-----: | :-------: | :---------: | +| About Meshtastic | `docs/software` | High level explanation of each part of Meshtastic. | +| Getting Started | `docs/getting-started` | Instructions on how to get the Meshtastic firmware onto a users device. | +| Device Settings | `docs/software/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. | +| Radio Mesh Details | `docs/mesh` | This section discusses everything relating to the Meshtastic mesh. Mesh health metrics will be discussed here as well as topics such as signal strength, range and anyting else pertaining to "over the air". | +| 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. | +| About the Documentation | `docs/about-documentation` | This section explains how our documentation is organized, how to make edits to the documentation, view a local copy of your fork of the project. Style guides and tips will also be included here. | +| 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. | diff --git a/docs/about-documentation/serve-docs-locally.md b/docs/about-documentation/serve-docs-locally.md new file mode 100644 index 00000000..92b3d566 --- /dev/null +++ b/docs/about-documentation/serve-docs-locally.md @@ -0,0 +1,42 @@ +--- +id: serve-docs-locally +title: Setting up Local Documentation +sidebar_label: Serve Docs Locally +--- +:::note +Some things won't display properly like logos or protobufs, this is not cause for concern. +::: +## Prerequisites +In order to set up your local environment, you will need to install: + +- [Node & Node package manager (NPM)](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [Yarn package manager](https://yarnpkg.com/getting-started/install) + +### Fork the Meshtastic Repository + +Log into Github and create a fork of the [meshtastic/Meshtastic](https://github.com/meshtastic/Meshtastic) repository. + +### Clone your Meshtastic Repository fork + +:::note +Replace `username` with your Github username. +::: + +```bash title="Clone username/Meshtastic Repo" +git clone https://github.com/username/Meshtastic.git +``` + +### Change directory to Local copy +```bash title="Change Directory" +cd ~/Meshtastic +``` + +### Install Dependencies +```bash title="Install dependencies using Yarn" +yarn install +``` + +### Run Development Server +```bash title="Run node.js server" +yarn start +``` diff --git a/sidebars.js b/sidebars.js index 5d6673b2..0bee3eb3 100644 --- a/sidebars.js +++ b/sidebars.js @@ -195,6 +195,7 @@ module.exports = { Documentation: { "About Documentation": [ "about-documentation/overview", + "about-documentation/serve-docs-locally", ] }, Legal: {