Skip to content

Latest commit

 

History

History

documentation

Documentation

The documentation is built using Docusaurus 2. The deployment is done through a centralized build from IOTA WIKI. To run a local instance the IOTA WIKI CLI is used.

Prerequisites

Installation

yarn

This command installs all necessary dependencies.

Local Development

yarn start

This command starts a local, wiki themed development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Features And Tools

You can find guidance and an introduction to the needed tools and syntax on our wiki

Default Structure

IOTA projects usually house their Wiki documentation in the documentation folder within their repositories. This template provides a structure to separate reader concerns, applying the Diataxis framework with some minor modifications.

You do not have to use all of these sections, so please feel free to delete any which do not suit your needs.

Getting Started

The Getting Started folder should be the first section in your documentation. It should give the user a high-level overview of the project, required prior knowledge, prerequisites, and ideally a quick setup guide, or "hello world".

How Tos

The How Tos folder should only address concrete examples, or how-to guides, which are goal-oriented.

Tutorials

The Tutorials folder should contain articles which guide the user step by step through a series of how-tos with the relevant explanations to achieve a project or real world use case. Tutorials are learning-oriented.

Key Concepts

The Key concepts folder revolves around explanations, and are therefore understanding-oriented.

Reference

The Reference folder should describe the technical information of your project. It is information-oriented.

Troubleshooting

The Troubleshooting file should contain instructions or links to where users can post questions, or create issues if necessary.

Contribute

The Contribute file should give the users directions and