Skip to main content

Contribute to OpenTezos

The excellent website you are currently browsing is called OpenTezos and will later be merged with the upcoming wiki.tezos.com. It is, therefore, important that all the content here is up to date and error-free. If you see an error, you can either submit an issue or go a step further by actually correcting the mistake yourself and submitting it for review. Here is how to proceed:

  • On the page that you see the error on, scroll down and click the link Edit this page.

FIGURE 1: Click Edit this page on the page containing an error

  • You are being redirected to the file on Gitlab corresponding to this chapter. Click on the pen logo on the upper right corner saying Fork this project and edit the file.

  • Click on the blue button with the down arrow to open the drop-down menu. Choose Edit and then click on the Fork button

FIGURE 2: Click Edit and then Fork on the Gitlab file

  • The chapter file is now opening in your browser. Proceed to edit its content to correct the error, then scroll down to the Commit message section. Enter a title and a description of your correction proposal, then click Commit changes.

FIGURE 3: Edit the chapter file and commit the changes

  • Gitlab now offers you to create a Merge request, i.e., propose your changes to the admins of the OpenTezos repository. Click Create merge request.

FIGURE 4: Create a merge request

Your merge request is now open and will be accepted and refused by the admins in the next few days. If accepted, your correction will be merged into the main code repository and published on OpenTezos.com. Thank you for your contribution!

Note that this tutorial only shows you the graphic way to proceed with a pull request using the Github interface. If you are proficient with Git, you can instead go through all these steps using the CLI.

Rules

We have a few basic rules for contributors, which are designed for quality control:

  • No --force pushes or modifications of Git history in any way.

  • Pull requests are preferred for issues, especially for minor changes such as typos. Issues should be used for generic or broad-based changes or missing content.

  • Only use non-master branches.

  • If there are significant modifications, even by contributors, they should be subject to a pull request to solicit feedback from other contributors.

  • Pull requests to solicit feedback are encouraged for any other non-trivial contribution; however, they are left to the contributor's discretion.

  • Contributors should attempt to adhere to the prevailing Markdown style, language, and layout.

  • Correct grammar should be used at all times. Pull requests with typos will not be merged until fixed. All content contributions must be made in English. We advise that you install Grammarly to spell-check your work before submitting it. (Note that it has a VSCode extension.) All the authors of OpenTezos are actively using Grammarly as it is a great tool.

  • Care should be taken to remain as objective and informative as possible. There should be no editorializing, nor should there be any external bias.

Diagrams

You might want to edit a diagram or create a new one. As you can see, OpenTezos has its own UI theme for diagrams and we ask all contributors to follow the same theme. To help you with this, you can find the source Figma file here. Duplicate it to edit existing diagrams. The page GRAPHIC STYLE contains examples of new diagrams along with all the graphic elements such as boxes and arrows. Note that you should never use custom colors, all allowed colors are saved in the Figma colors profile. Just pick colors from there when you need one.

To go further

Any other type of contribution is also welcome. You can even write new chapters or new modules for OpenTezos or modify graphic elements if you want to. We look into all pull requests with great attention. However, please do not try to pull-request any marketing material as this will be immediately rejected.