Skip to content
πŸ“– TomoChain documentation
Branch: master
Clone or download
Latest commit 17769c8 Feb 26, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
docs Fix lists in masternode docs Feb 25, 2019
material_override update structure Oct 4, 2018
.gitignore update gitignore Oct 3, 2018
.travis.yml
LICENSE
README.md correct phrasing Oct 3, 2018
mkdocs.yml Add create-tomochain-masternode to the navigation Feb 25, 2019
requirements.txt
serve.sh

README.md

TomoChain Documentation

Join the chat at https://gitter.im/tomochain/docs

TomoChain documentation.

Requirements

  • python
  • virtualenv

Contribute

Clone the project.

git clone https://github.com/tomochain/docs.git

Create a virtualenv for this project.

cd docs
virtualenv .env

Activate your virtualenv.

source .env/bin/activate

Install the required libraries in your project's virtualenv.

pip install -r requirements.txt

You can now edit some files and check your changes live by running a local server. You can access it at localhost:3000.

./ serve.sh

Note: don't forget to activate/deactivate your virtualenv when you start/stop working on this project.

# activate: from the project folder
source .env/bin/activate

# deactivate: from everywhere
deactivate

Contribution guideline

Branches

If you are a technical writer with assigned issues, please work on a separate branch for each of them.

They should be named tw/[id of the issue]

Example:

git checkout -b tw/24

All other branches can be named with a short descriptive word.

Example:

git checkout -b guidelines

Commits

Commits should start by a verb.

Example:

fix typo in technical whitepaper

Markdown

When contributing to the documentation, please write one sentence per line.

This will not create a new paragraph as markdown require two blank line to create one.

It will help keep git diffs clearer. When editing a file, if you see multiples sentences in one line, it would be welcomed if you split them.

Example:

Hello, this is the first paragraph.
This is still the first paragraph and this is still on the same line.

This is on a new paragraph because there is two new lines.

Hello, this is the first paragraph. This is still the first paragraph and this is still on the same line.

This is on a new paragraph because there is two new lines.

You can’t perform that action at this time.