> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing to the unit catalog

> Learn how to contribute new units and unit systems to the Cognite global unit catalog through GitHub.

At Cognite, we maintain a global unit catalog filled with units and unit systems that are accessible to all CDF projects. We believe in the power of open-source and collaboration, so we've made our unit catalog open to contributions from our users.

While we encourage contributions to enhance the unit catalog, it is important to note that the catalog is made available to all Cognite customers. Therefore, we will carefully evaluate each submission to ensure that the additions are suitable for our broad customer base.

## How to contribute

<Steps>
  <Step title="Access the unit catalog repository">
    Visit [cognitedata/units-catalog](https://github.com/cognitedata/units-catalog) to access the public repository.

    <Info>
      You need a GitHub account to contribute.
    </Info>
  </Step>

  <Step title="Familiarize yourself with the project">
    Read the **README** file to understand the project structure, contribution guidelines, and validation requirements.
  </Step>

  <Step title="Make your changes">
    1. Edit the `units.json` and/or `unitSystems.json` files to add your new units or unit systems. Ensure that your additions conform to the validation rules and tests outlined in the README.
    2. Provide a reliable source for the unit conversion factors. Accepted sources include UoM standards (e.g., Energistics, qudt.org), books, or journals. Google or Wikis are not considered valid sources.
  </Step>

  <Step title="Submit a pull request">
    1. Save your changes and raise a Pull request (PR).
    2. To expedite the review process, we recommend creating one PR per unit, or bundling up to 5 units per PR. Larger PRs may take longer to review.
  </Step>

  <Step title="Review and approval">
    Your PR will be reviewed by Cognite engineering to ensure it meets the contribution guidelines and is suitable for inclusion in the unit catalog.

    The review process may result in a request for changes or clarification, or the PR may be accepted and merged directly.
  </Step>

  <Step title="Release and deployment">
    1. After reviewing and merging approved PRs, Cognite creates new releases of the unit catalog at most every 2 months, depending on contributions.
    2. Critical bug fixes may be released outside of this schedule as needed.
    3. Once a release is issued on GitHub, the changes are deployed across all CDF clusters within the following two weeks.
  </Step>
</Steps>

<Note>
  Cognite reserves the right to evaluate and refuse additions that are not suitable for our broad customer base. We appreciate your understanding and cooperation in this regard.
</Note>