diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 55816fb999cb..c93011fdaf0b 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -41,3 +41,4 @@ content/en/docs/kubernetes/helm/ @open-telemetry/docs-approvers @open-te content/en/docs/specs/ @open-telemetry/docs-approvers @open-telemetry/specs-approvers content/en/docs/security/ @open-telemetry/docs-approvers @open-telemetry/sig-security-maintainers content/en/ecosystem/demo/ @open-telemetry/demo-approvers @open-telemetry/demo-approvers +content/en/docs/contributing/ @open-telemetry/docs-approvers @open-telemetry/docs-maintainers \ No newline at end of file diff --git a/content/en/docs/contributing/_index.md b/content/en/docs/contributing/_index.md index f4d471831a14..8ec8066b23be 100644 --- a/content/en/docs/contributing/_index.md +++ b/content/en/docs/contributing/_index.md @@ -537,7 +537,7 @@ Pull requests are merged when they comply with the following criteria: > **Important** > -> Do not worry too much about failing PR checks! Community members will help you +> Do not worry too much about failing PR checks. Community members will help you > to get them fixed, by either providing you with instructions how to fix them > or by fixing them on your behave. @@ -596,17 +596,19 @@ Keep the following in mind when filing an issue: ## Contribute to other repositories -The OpenTelemetry project contains many repositories. Several of these -repositories contain documentation: user-facing help text, error messages, API -references or code comments. +OpenTelemetry is an open source project, and we gladly accept new contributions +and contributors. See the CONTRIBUTING.md file in each SIG repository for +information on getting started. + +Individual SIGs may maintain documentation above and beyond what is offered +here, but we strive for accurate general guidance on using the project from our +main website. If you see text you'd like to improve, use GitHub to search all repositories in the OpenTelemetry organization. This can help you figure out where to submit -your issue or PR. - -Each repository has its own processes and procedures. Before you file an issue -or submit a PR, read that repository's `README.md`, `CONTRIBUTING.md`, and -`code-of-conduct.md`, if they exist. +your issue or PR. Each repository has its own processes and procedures. Before +you file an issue or submit a PR, read that repository's `README.md`, +`CONTRIBUTING.md`, and `code-of-conduct.md`, if they exist. Most repositories use issue and PR templates. Have a look through some open issues and PRs to get a feel for that team's processes. Make sure to fill out @@ -621,3 +623,8 @@ the templates with as much detail as possible when you file issues or PRs. [dashboard]: https://app.netlify.com/sites/opentelemetry/overview [deploy preview]: https://www.netlify.com/blog/2016/07/20/introducing-deploy-previews-in-netlify/ + +## Code of conduct + +OpenTelemetry follows the +[CNCF Community Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). diff --git a/content/en/docs/contributing/style-guide.md b/content/en/docs/contributing/style-guide.md index 9109823f7d1c..5e874ffd00d2 100644 --- a/content/en/docs/contributing/style-guide.md +++ b/content/en/docs/contributing/style-guide.md @@ -25,10 +25,8 @@ the site. | OpenTelemetry | OpenTelemetry should always be capitalized. Don't use Open-Telemetry. | | OTel | OTel is the accepted short form of OpenTelemetry. Don't use OTEL. | | Collector | When referring to the OpenTelemetry Collector, always capitalize Collector. | -| Repository | Code repository, lowercase when in the middle of a sentence. Don't use "repo" or "repos". | | OTEP | OpenTelemetry Enhancement Proposal. Write "OTEPs" as plural form. Don't write "OTep" or "otep". | | OpAMP | Open Agent Management Protocol. Don't write "OPAMP" or "opamp" in descriptions or instructions. | -| OTLP | OpenTelemetry Protocol. Don't write "OTlP" or "otlp" in descriptions or instructions. | Make sure that proper nouns, such as other CNCF projects or third-party tools, diff --git a/content/en/docs/contribution-guidelines.md b/content/en/docs/contribution-guidelines.md deleted file mode 100644 index a09510f1cd42..000000000000 --- a/content/en/docs/contribution-guidelines.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Contribution guidelines -description: How to contribute to OpenTelemetry -toc_hide: true ---- - -OpenTelemetry is an open source project, and we gladly accept new contributions -and contributors. See the CONTRIBUTING.md file in each SIG repository for -information on getting started. - -## Contribute to the OpenTelemetry Documentation - -To learn how to contribute fixes and new content to this project, read the -[Contributor's guide](/docs/contributing), which includes a style guide and -useful information on the review process. - -Individual SIGs may maintain documentation above and beyond what is offered -here, but we strive for accurate general guidance on using the project from our -main website. - -The per-language API, SDK, and "Getting Started" documentation is hosted in each -language's GitHub repository. For more information, -[see the Mirrored Documentation section](https://github.com/open-telemetry/opentelemetry.io/blob/main/CONTRIBUTING.md#mirrored-documentation) -of the website repository's CONTRIBUTING.md file. - -### Contributor License Agreement (CLA) - -Contributors to this and other OpenTelemetry projects require acceptance of our -CLA, managed by [EasyCLA](https://lfcla.com/). - -### Code reviews - -All submissions, including submissions by project members, require review. We -use GitHub pull requests for this purpose. Consult -[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more -information on using pull requests. - -### Getting started - -See [README.md](https://github.com/open-telemetry/opentelemetry.io#readme) for -current information. - -## Code of conduct - -OpenTelemetry follows the -[CNCF Community Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). diff --git a/layouts/shortcodes/community-lists.md b/layouts/shortcodes/community-lists.md index 399fe7ef1c3d..71947d990152 100644 --- a/layouts/shortcodes/community-lists.md +++ b/layouts/shortcodes/community-lists.md @@ -18,7 +18,7 @@ {{ template "community-links-list" . }} {{ end }} -{{ T "community_how_to" . }} {{ T "community_guideline" }}. +{{ T "community_how_to" . }} {{ T "community_guideline" }}. {{ define "community-links-list" -}} {{ range . }}