Welcome to OpenTelemetry specifications repository!
Before you start - see OpenTelemetry general contributing requirements and recommendations.
Before you can contribute, you will need to sign the Contributor License Agreement.
Significant changes should go through the RFC process.
Specification is written in markdown format. Please make sure files are rendered OK on GitHub.
Markdown files should be properly formatted before a pull request is sent out. In this repository we follow the markdownlint rules with some customizations. See mdlstyle or settings for details.
We highly encourage to use line breaks in markdown files at 80 characters
wide. There are tools that can do it for you effectively. Please submit proposal
to include your editor settings required to enable this behavior so the out of
the box settings for this repository will be consistent.
To check for style violations, use
# Ruby and gem are required for mdl
gem install mdl
mdl -c .mdlrc .To fix style violations, follow the
instruction
with the Node version of markdownlint. If you are using Visual Studio Code,
you can also use the fixAll command of the
vscode markdownlint extension.
In addition, please make sure to clean up typos before you submit the change.
To check for typos, use
# Golang is needed for the misspell tool.
make install-misspell
make misspellTo quickly fix typos, use
make misspell-correction