CONTRIBUTING.md

Contributor's Guide

Welcome to the Gnosis Documentation site! We welcome all contributors.

Environments

Prod: https://docs.gnosischain.com Staging: https://developers-portal.staging.gnosisdev.com

A password is required for the Staging site: plase ask @alebanzas or @plato_gno for it.

Git Workflow

• release branch: the current state of docs.gnosischain.com
• main branch: the current state of the docs staging site
• Feature branches: individual contributors issue a PR to main branch

Currently, @alebanzas and @plato_gno have push rights to release branch.

Run the project

Prerequisites

Node.js version 14.13 or higher.

Installation

$ yarn install

Local Development

$ yarn start

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

Build

$ yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Contents

• Docs are located in the docs directory.
• Landing pages are located in the src/pages directory.
• Images and static files are located in the static directory.
• The left side-bar of the page is controlled by sidebars.js.
• Docusaurus complete documentation can be found here.

Submit an Issue

Start by searching if an issue already exists. If a related issue doesn't exist, you can open a new issue following the instructions of the template accordingly.

Issues are categorized by type:

• Feature
• Content
• Bug

Creating Pull Requests

For help, see GitHub Docs: Linking a pull request to an issue using a keyword.

• Submit a PR against the main branch of the gnosischain/documentation repo
• Follow the PR template instructions carefuly

Writing style

We selected a collection of best practices from the industry to make the website easy to read, global, diverse and searchable

• General Writing Guidelines (by OpenStack)
• Bias-free communication (by Microsoft)
• Global communications (by Microsoft)

Transfering Gitbook Pages

When transfering documents from the old gitbook, consider the funcionality difference detailed below, and the following:

• Relevance and validity of the content
• xdaichain was renamed to gnosis
• Open Ethereum was deprecated
• Nifty Wallet deprecation
• Internal and external links

Static Assets

/static
    /files
    /img
        # By Docs folders
        /about
        /bridges
        /developers
        /node

Gitbook

/.gitbook/assets/

Docusaurus

/static/img/

Alerts

Gitbook

{% hint style="info" %}
Message
{% endhint %}

Docusaurus

:::info
Message
:::

Refer to docusaurus docs for more admonition types.

Tabs

Refer to docusaurus docs for details on tabs.

Useful Tools

• Markdown Link Updater