Contributing

Thanks for your interest in contributing to the OpenTelemetry docs and website.

Jump right in!

What do you want to do?

What can I contribute to?

OpenTelemetry documentation contributors:

The pages in this section describe how to contribute to OpenTelemetry documentation.

For guidance on how to contribute to the OpenTelemetry project in general, see the community OpenTelemetry New Contributor Guide. Every OTel repository for language implementations, the Collector, and conventions have their own project-specific contributing guides.


Prerequisites

To contribute, you need to be familiar with the following techs and tools.

Issues

How to fix an existing issue, or report a bug, security risk, or potential improvement.

Submitting content

Learn how to submit new or changed content using the GitHub UI or a local fork.

Documentation style guide

Terminology and style when writing OpenTelemetry docs.

Site localization

Creating and maintaining site pages in non-English localizations.

Blog

Learn how to submit a blog post.

Pull request checks

Learn how to make your pull request successfully pass all checks

Announcements

Create announcements or banners for special events.

Development setup and commands to build, serve, and more

Learn how to set up a development environment for the opentelemetry.io site.

SIG practices for approver and maintainers

Learn how approvers and maintainers manage issues and contributions.

Acknowledgements

Acknowledgements for sources for content on this site