Hyperledger Iroha 2 Tutorial

This repository contains the source files for Hyperledger Iroha 2 Tutorial.

The tutorial is suitable for both experienced and novice users. It explains Iroha 2 concepts and features, and also offers language-specific step-by-step guides for these programming languages:

If you are already familiar with Hyperledger Iroha, we invite you to read about how Iroha 2 is different from its previous version.

Check the Hyperledger Iroha 2 repository for more detailed information about API and available features.

Contribution

If you want to contribute to Iroha 2 tutorial, please clone the repository and follow the steps below.

Prepare the environment

Install Node.js v16.9+. To install it without a headache, use NVM (Node Version Manager). You can run something like this:

# Install NVM itself
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# Run it to use NVM in the current shell session or restart your shell
export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

Then you can install Node 18:

nvm install 18

Enable Corepack:
```
corepack enable
```
Install project dependencies. From the root of the cloned repository, run:
```
pnpm install
```

Run dev mode

pnpm dev

It will start a local dev-server. You will be able to open a browser, observe rendered documentation, edit source files and see your edits on-demand.

Formatting

We use Prettier to format project sources. Its configuration is located at ./.prettierrc.js. Check options reference for all available options.

Format sources: apply formatting to all project source files:
```
pnpm format:fix
```
Check the formatting in sources: ensure that all project source files match Prettier code style
```
pnpm format:check
```

We use prettier-eslint tool to override Prettier formatting for Vue components.

Linting

To check whether ESLint rules pass, run:

pnpm lint

To fix auto-fixable issues, run:

pnpm lint --fix

Testing

We use Vitest test framework to assure quality of non-trivial internal parts of the project.

To check whether tests pass, run:

pnpm vitest run

To run vitest in a watch-mode, run:

pnpm vitest

Enabling feedback form

In order to enable the "Share feedback" button, the following environment variable should be provided:

VITE_FEEDBACK_URL=https://example.com/get-feedback

When a user submits the form, a simple POST request with a JSON body is sent to this URL.

This variable will be picked up by the application during dev/build mode. Read more about it in the Vite documentation.

License

Iroha documentation files are made available under the Creative Commons Attribution 4.0 International License (CC-BY-4.0), available at http://creativecommons.org/licenses/by/4.0/

d4v1d03 / iroha-2-docs