# Guide

Contributions from the community are welcome! Don't worry if you have litte experience working with open source projects or git, here are some guidelines to get you started.

# How can I help?

First off — thank you for taking interest in helping this project grow. There are many ways you can contribute — tell your friends about ARManual, fix typos you find, correct outdated information, translate it to a language you know or even write new content. Anything helps! Furthermore, go to our Github Issue page (opens new window), check out the issues with a label help wanted and see if you could fix that issue.

# Issues

If you have any suggestions, questions or found a bug, please go to our Github Issue page (opens new window) and submit a new issue.

# Simple editing

If you found a typo, incorrect information or would like to clarify something, follow these steps:

  • Scroll to the bottom of the page you want to edit and click Edit this page link. You will be taken to Github and in order to make edits, you will need to create an account, if you don't have one already.
  • After you log in, click Fork this repository and propose changes button.
  • Make the changes to the page and explain why and what have you changed in the Propose file change section.
  • Click Propose file change button and Create pull request in the next page.
  • Make sure your pull request has an appropriate title and description and click Create pull request

Thank you for improving ARManual! We will review your changes and you should see them on the webpage after we approve them. Check back on your pull request (opens new window) every once in a while — you might find some comments and questions there.

# Advanced editing

# Vuepress

Project is built using Vuepress (opens new window).

# Running locally

# Windows

I would recommend using WSL (opens new window) to get Git and Node running.

# MacOS

Install Git and Node as described here (opens new window) (or follow any other guide you find).

# Linux

Install Git and Node using your distro package manager.


  1. After you have the prerequisites installed, fork and clone ARManual repository and create a new branch (opens new window).

  2. Install dependencies

npm install # or yarn
  1. Run the dev server
npm run dev # or yarn dev

After that, visit localhost:8080 and you should see ARManual running locally.

# Project structure

.
├── ARManual
│   ├── .vuepress
│   ├── contribute
|   ├── phonetic-alphabet
|   ├── q-code
|   ├── radio-operating-ethics
│   └── lt
│       ├── contribute
│       ├── phonetic-alphabet
│       ├── q-code
│       └── radio-operating-ethics
├── CHANGELOG.md
├── LICENSE
├── package.json
└── README.md

This is a simplified diagram of directory structure.

  • ARManual/ folder contains all the content presented on this webpage.
  • ARManual/.vuepress contains Vuepress configuration and style files, component and public directories. More information about it can be found on Vuepress documentation (opens new window), but it rarely needs modification.



 
 
 
 







.
├── ARManual
│   ├── .vuepress
│   ├── contribute
│   ├── phonetic-alphabet
|   ├── q-code
|   ├── radio-operating-ethics
│   └── lt
│       ├── contribute
|       ├── phonetic-alphabet
|       ├── q-code
│       └── radio-operating-ethics
...

Directories like ARManua/contribute/ or ARManual/q-code/ are page or page group folders. Page is a directory with a single README.md file. Page group is a directory containing a README.md and other .md files for additional pages.

WARNING

If you want to create a new page or page group, you need to modify ARManual/.vuepress/config.js file themeConfig.locales.sidebar property in order to see your page in the navigation menu. Try doing this yourself following already existing code as an example, but don't be afraid to ask for help on Github if you get stuck!








 
 
 
 
 


.
├── ARManual
│   ├── .vuepress
│   ├── contribute
│   ├── phonetic-alphabet
|   ├── q-code
|   ├── radio-operating-ethics
│   └── lt
│       ├── contribute
|       ├── phonetic-alphabet
|       ├── q-code
│       └── radio-operating-ethics
...

Folders named using a two-letter language code are language directories. The default language of this project is English, therefore ARManual/contribute/ and ARManual/radio-operating-ethics/ don't need to be nested in a language directory. Additional languages must have a language directory and it should contain the same page and page group folders as does English.

Last Updated: 10/18/2018, 10:12:19 AM