Skip to content

Latest commit

 

History

History
82 lines (54 loc) · 2.9 KB

CONTRIBUTING.md

File metadata and controls

82 lines (54 loc) · 2.9 KB

Superchain-Ops Contributing Guide

Welcome to the Superchain-Ops Contributing Guide! Before diving into the specifics of this repository, know that you should always feel free to report issues in this repository. Great bug reports are detailed and give clear instructions for how a developer can reproduce the problem. Write good bug reports and developers will love you.

Important

If you believe your report impacts the security of this repository, refer to the canonical Security Policy document from the Optimism monorepo.

Developer Quick Start

Setting Up

Clone the repository and open it:

git clone https://github.com/ethereum-optimism/superchain-ops
cd superchain-ops

Software Dependencies

You will need to install a number of software dependencies to effectively contribute to the Optimism Monorepo. We use mise as a dependency manager for these tools. Once properly installed, mise will provide the correct versions for each tool. mise does not replace any other installations of these binaries and will only serve these binaries when you are working inside of the optimism directory.

Install mise

Install mise by following the instructions provided on the Getting Started page.

Trust the mise.toml file

mise requires that you explicitly trust the mise.toml file which lists the dependencies that this repository uses. After you've installed mise you'll be able to trust the file via:

mise trust mise.toml

Install dependencies

Use mise to install the correct versions for all of the required tools:

mise install

Installing updates

mise will notify you if any dependencies are outdated. Simply run mise install again to install the latest versions of the dependencies if you receive these notifications.

Building the repo

You must install all of the required Software Dependencies to build the repo. Once you've done so, run the following command to build:

just build

Running tests

Before running tests: follow the above instructions to get everything built. Once done, you can run tests as follows:

just test

Contributions Related to Spelling and Grammar

At this time, we will not be accepting contributions that primarily fix spelling, stylistic or grammatical errors in documentation, code or elsewhere.

Pull Requests that ignore this guideline will be closed, and may be aggregated into new Pull Requests without attribution.

Code of Conduct

Interactions within this repository are subject to a Code of Conduct adapted from the Contributor Covenant.