This repository contains the source for the Okuna documentation page - https://docs.okuna.io.

Table of Contents

• Requirements
• Project Overview
• Contributing
  • Code of Conduct
  • License
  • Other issues
  • Git commit message conventions
• Getting Started

Requirements

Git, Node (8.x or higher), and Yarn.

Project Overview

The website is a static site generated using Vuepress.

Other relevant technologies:

• SCSS for stylesheets
• Pug for Vue templating

Contributing

There are many different ways to contribute to the website development, just find the one that best fits with your skills and open an issue/pull request in the repository.

Examples of contributions we love include:

• Documentation fixes
• Code patches
• Bug reports
• Patch reviews
• Translations
• UI enhancements

Code of Conduct

Please read and follow our Code of Conduct.

License

Every contribution accepted is licensed under AGPL v3.0 or any later version. You must be careful to not include any code that can not be licensed under this license.

Please read carefully our license and ask us if you have any questions.

Responsible disclosure

Cyber-hero? Check out our Vulnerability Disclosure page.

Other issues

We're available almost 24/7 in the Okuna Slack channel. Join us!

Git commit message conventions

Help us keep the repository history consistent 🙏!

We use gitmoji as our git message convention.

If you're using git in your command line, you can download the handy tool gitmoji-cli.

Getting Started

Clone the repository:

git clone git@github.com:OkunaOrg/okuna-docs.git
cd okuna-docs

Install the dependencies using Yarn:

npm i -g yarn
yarn

Directory Structure

The source directory contains the raw Markdown source of the articles, as well as a special .vuepress directory, which holds all the configuration (settings, theme, assets, etc.) of the Vuepress instance. The pages will be generated in the source/.vuepress/dist directory. This directory is elemental for the gh-pages branch.

Configuration

You can change navigation menu items, languages, and other settings in the source/.vuepress/config.js file. For more information on how to use the config file, please refer to the Vuepress Config Reference.

Development

For development purposes, it is recommended that you run yarn dev in a designated terminal tab/window. Vuepress supports hot reloading, so all your changes will be automatically applied and reloaded in your browser so long as yarn dev is running.

Linting

We like clean code, so before you commit, we would appreciate it if you've ran your changes through the linter! If you have done changes to the source code, you can use the following command to start linting:

yarn lint

and to automatically fix most issues:

yarn lint:fix

Building and Deployment

To build the production assets, you need to run the following command:

yarn build

Once the build has finished, you can stage your changes and commit them to the master branch. Only then you can deploy your changes to GitHub Pages by running the following command:

yarn deploy

or the slightly longer, but often more reliable variant:

git subtree push --prefix source/.vuepress/dist origin gh-pages

Questions/stuck?

Join our Slack channel, we're happy to help you troubleshoot your issue.