OpenTelemetry.io

This is the source repository for the OpenTelemetry website, project
documentation and blog. The site is built using Hugo and
hosted on Netlify.

Get involved

If you are new to OpenTelemetry and just get started with it, you are in a
perfect position to help us get better: the website and documentation is the
entry point for newcomers like you, so if something is unclear or something is
missing let us know!

Read on to learn about other ways on how you can help.

Adding a project to the OpenTelemetry Registry

For details, see Adding to the registry.

Submitting a blog post

You can submit a blog post either by forking this repository and writing it
locally or by using the GitHub UI. In both cases we ask you to follow the
instructions provided by the blog post template.

Note: Before writing a blog post, please ask yourself, if your content also
might be a good addition to the documentation. If the answer is yes, create a
new issue/PR with your content to get it added to the docs.

Fork & Write locally

Follow the setup instructions then, to create a skeletal blog
post, run the following command from the repository root:

npx hugo new content/en/blog/2023/short-name-for-post.md

If your post will have images or other assets, instead run:

npx hugo new content/en/blog/2023/short-name-for-post/index.md

Edit the markdown file at the path you provided in the previous command. The
file is initialized from the blog-post starter under archetypes.

Put assets, if any, like images into the folder created.

Once your post is ready, submit it through a pull request.

Using the GitHub UI

• Go to the blog post template and click on
  Copy raw content at the top right of the menu.
• Create a new file.
• Paste the content from the template.
• Name your file, e.g.
  content/en/blog/2022/short-name-for-your-blog-post/index.md
• Start editing the markdown file.
• Once your post is ready click on Propose changes at the bottom.

Contributing

See CONTRIBUTING.md.

We have curated some issues with the tags help wanted and good first
issue. This should allow you to quickly find a place to contribute

We (OTel Comms SIG) meet every two weeks on Monday at 9:00 PT. Check out the
OpenTelemetry community calendar for the Zoom link and any updates to this
schedule.

Meeting notes are available as a public Google doc. If you have trouble
accessing the doc, please get in touch on Slack.

Here is a list of community roles with current and previous members:

• Approvers: @open-telemetry/docs-approvers

  • Fabrizio Ferri-Benedetti, Splunk
  • Michael Hausenblas, Amazon

• Maintainers: @open-telemetry/docs-maintainers

  • Austin Parker, Honeycomb
  • Patrice Chalin, CNCF
  • Phillip Carter, Honeycomb
  • Severin Neumann, Cisco

• Emeritus approvers:

  • Paul Bruce

• Emeritus maintainers:

  • Steve Flanders
  • Morgan McLean
  • jparsana

Learn more about roles in the community repository. Thanks to all who have
already contributed!

Licenses

• Documentation: CC-BY-4.0
• Code: Apache-2.0