Skip to content

Latest commit

 

History

History
81 lines (57 loc) · 3.53 KB

CONTRIBUTING.md

File metadata and controls

81 lines (57 loc) · 3.53 KB
Raw

Contribution Guidelines

Reporting Issues

Please open an issue if you find a bug or have a feature request. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted

The more detailed your report is, the faster it can be resolved. If you report a bug, please provide steps to reproduce this bug and revision of code in which this bug reproduces.

Code

If you would like to contribute code to fix a bug, add a new feature, or otherwise improve our project, pull requests are most welcome.

Quick maintenance guide

  • The Octez revision used is located in the meta.json and flake.lock file. You can update these to the latest available revision with the update-tezos.sh script
  • Used tezos protocols can be changed by proto script. This script requires jq and moreutils to be installed. Currently used protocols are displayed in protocols.json.
    • To add a new protocol, ./proto activate ....
    • To stop building protocol-specific binaries for a protocol, but keep supporting it in multi-protocol binaries, ./proto allow.
    • To deprecate a protocol, ./proto ignore ....
  • Note that this script is location sensitive, and required to be used from the scripts folder.

Nix specific maintenance

All nix related files are located in the nix directory.

If the build breaks because of a dependency issue, nix repl --extra-experimental-features repl-flake .# can be very useful to investigate it.

Legal

We want to make sure that our projects come with correct licensing information and that this information is machine-readable, thus we are following the REUSE Practices – feel free to click the link and read about them, but, basically, it all boils down to the following:

  • Add the following header at the very top (but below the shebang, if there is one) of each source file in the repository (yes, each and every source file – it is not as hard as it might sound):

    # SPDX-FileCopyrightText: 2022 Oxhead Alpha
#
# SPDX-License-Identifier: LicenseRef-MIT-OA

    (This is an example for Nix; adapt it as needed for other languages.)

    The license identifier should be the same as the one in the LICENSE file.

  • If you are copying any source files from some other project, and they do not contain a header with a copyright and a machine-readable license identifier, add it, but be extra careful and make sure that information you are recording is correct.

    If the license of the file is different from the one used in the project and you do not plan to relicense it, use the appropriate license identifier and make sure the license text exists in the LICENSES directory.

    If the file contains the entire license in its header, it is best to move the text to a separate file in the LICENSES directory and leave a reference.

  • If you are copying pieces of code from some other project, leave a note in the comments, stating where you copied it from, who is the copyright owner, and what license applies.

  • All the same rules apply to documentation that is stored in the repository.

These simple rules should cover most of situation you are likely to encounter. In case of doubt, consult the REUSE Practices document.