Merge branch 'main' into logs-configuration-patch

.commit-me.json

@@ -0,0 +1,4 @@
+{
+  "include-pull-requests": true,
+    "types": [ "chore", "ci", "docs", "feat", "fix", "perf", "refactor", "release", "revert", "squash", "style", "test" ]
+}

.github/dependabot.yml

@@ -0,0 +1,91 @@
+---
+version: 2
+updates:
+- package-ecosystem: github-actions
+  directory: "/"
+  schedule:
+    interval: daily
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/api"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/common"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/jaeger"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/otlp"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/otlp-common"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/otlp-grpc"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/otlp-http"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/otlp-metrics"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/exporter/zipkin"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/logs_api"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/logs_sdk"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/metrics_api"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/metrics_sdk"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/propagator/b3"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/propagator/jaeger"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/registry"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/sdk"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/sdk_experimental"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/semantic_conventions"
+  schedule:
+    interval: weekly
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: weekly

.github/workflows/ci-markdown-link.yml

@@ -0,0 +1,17 @@
+name: Markdown Link Check
+
+on:
+  pull_request:
+
+jobs:
+  markdown-link-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: "Markdown Link Check"
+        uses: gaurav-nelson/github-action-markdown-link-check@v1
+        with:
+          config-file: '.markdown-link-check.json'
+          use-quiet-mode: 'yes'
+          use-verbose-mode: 'yes'

.github/workflows/ci-markdownlint.yml

@@ -0,0 +1,20 @@
+name: Markdown Lint Check
+
+on:
+  pull_request:
+
+jobs:
+  markdownlint-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # equivalent cli: markdownlint-cli2  "**/*.md" "#**/CHANGELOG.md"  --config .markdownlint.json
+      - name: "Markdown Lint Check"
+        uses: DavidAnson/markdownlint-cli2-action@v16
+        with:
+          fix: false
+          globs: |
+            **/*.md
+            !**/CHANGELOG.md
+          continue-on-error: true

.github/workflows/conventional-commits.yml

@@ -0,0 +1,32 @@
+name: Conventional Commits Validation
+
+on:
+  workflow_dispatch:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - edited
+
+permissions:
+  contents: read
+  pull-requests: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}  # Ensure that only one instance of this workflow is running per Pull Request
+  cancel-in-progress: true  # Cancel any previous runs of this workflow
+
+jobs:
+  validate-commits:
+    name: Conventional Commits Validation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: dev-build-deploy/[email protected]
+        env:
+          FORCE_COLOR: 3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          include-commits: false
+          update-labels: false
+          config: ".commit-me.json"

.markdown-link-check.json

@@ -0,0 +1,10 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^http://localhost"
+    }
+  ],
+  "timeout": "5s",
+  "retryOn429": true,
+  "aliveStatusCodes": [200, 206, 429]
+}

.markdownlint.json

@@ -0,0 +1,13 @@
+{
+  "emphasis-style": false,
+  "line-length": false,
+  "link-fragments": false,
+  "list-marker-space": false,
+  "no-emphasis-as-heading": false,
+  "no-hard-tabs": false,
+  "no-inline-html": false,
+  "no-trailing-punctuation": false,
+  "no-trailing-spaces": true,
+  "custom-rules-below-this-point": false,
+  "trim-code-block-and-unindent": true
+}

CONTRIBUTING.md

@@ -24,7 +24,7 @@ conforms to the specification, but the interface and structure are flexible.
 It is preferable to have contributions follow the idioms of the language
 rather than conform to specific API names or argument patterns in the spec.
 
-For a deeper discussion, see: https://github.com/open-telemetry/opentelemetry-specification/issues/165
+For a deeper discussion, see: <https://github.com/open-telemetry/opentelemetry-specification/issues/165>
 
 ## Getting started
 
@@ -40,6 +40,7 @@ git clone [email protected]:YOUR_GITHUB_NAME/opentelemetry-ruby.git
 ```
 
 or
+
 ```sh
 git clone https://github.com/YOUR_GITHUB_NAME/opentelemetry-ruby.git
 ```
@@ -66,11 +67,11 @@ _Setting up a running Ruby environment is outside the scope of this document._
 
 This repository contains multiple Ruby gems:
 
- *  `opentelemetry-api` located in the `api` directory
- *  `opentelemetry-sdk` located in the `sdk` directory
- *  Various instrumentation gems located in subdirectories of `instrumentation`
- *  Various exporter gems located in subdirectories of `exporter`
- *  `opentelemetry-resource_detectors` located in the `resource_detectors` directory
+*  `opentelemetry-api` located in the `api` directory
+*  `opentelemetry-sdk` located in the `sdk` directory
+*  Various instrumentation gems located in subdirectories of `instrumentation`
+*  Various exporter gems located in subdirectories of `exporter`
+*  `opentelemetry-resource_detectors` located in the `resource_detectors` directory
 
 Each of these gems has its configuration and tests.
 
@@ -89,10 +90,10 @@ configuration details.
 
 The services provided include:
 
- *  `app` - main container environment scoped to the `/app` directory. Used
+*  `app` - main container environment scoped to the `/app` directory. Used
     primarily to build and tag the `opentelemetry/opentelemetry-ruby:latest` image.
- *  `api` - convenience environment scoped to the `api` gem in the `/app/api` directory.
- *  `sdk` - convenience environment scoped to the `sdk` gem in the `/app/sdk` directory.
+*  `api` - convenience environment scoped to the `api` gem in the `/app/api` directory.
+*  `sdk` - convenience environment scoped to the `sdk` gem in the `/app/sdk` directory.
 
 To test using Docker:
 
@@ -154,8 +155,8 @@ to ensure that your code complies before opening a pull request.
 We also use Yard to generate class documentation automatically. Among other
 things, this means:
 
- *  Methods and arguments should include the appropriate type annotations
- *  You can use markdown formatting in your documentation comments
+*  Methods and arguments should include the appropriate type annotations
+*  You can use markdown formatting in your documentation comments
 
 You can generate the docs locally to see the results, by running:
 
@@ -249,7 +250,7 @@ Releases are normally performed using GitHub Actions.
      *  For each gem, it will create a release tag and a GitHub release.
      *  It will build and push the gems to rubygems.
      *  It will build the docs and push them to
-        https://open-telemetry.github.io/opentelemetry-ruby
+        <https://open-telemetry.github.io/opentelemetry-ruby>
      *  If the releases succeed, the script will update the release pull
         request with the results and change its label to `release: complete`.
         If something went wrong, the script will, if possible, report the error
@@ -269,15 +270,15 @@ review the release logs for the GitHub Actions workflows.
 
 There are four GitHub actions workflows related to releases.
 
- *  `Open release request` is the main release entrypoint, and is used to open
+*  `Open release request` is the main release entrypoint, and is used to open
     a release pull request. If something goes wrong with this process, the logs
     will appear in the workflow run.
- *  `Force release` is generally used only to restart a failed release.
- *  `[release hook] Update open releases` is run on pushes to the main branch,
+*  `Force release` is generally used only to restart a failed release.
+*  `[release hook] Update open releases` is run on pushes to the main branch,
     and pushes warnings to open release pull requests if you make modifications
     before triggering the release (i.e. because you might need to update the
     changelogs.)
- *  `[release hook] Process release` is the main release automation script and
+*  `[release hook] Process release` is the main release automation script and
     is run when a pull request is closed. If it determines that a release pull
     request was merged, it kicks off the release process for the affected gems.
     It also updates the label on a closed release pull request. Finally, it
@@ -320,7 +321,7 @@ changed gems.
 
 To force-release, assuming the version and changelog are already modified:
 
-```
+```sh
 toys release perform --rubygems-api-key=$API_KEY $GEM_NAME $GEM_VERSION
 ```
 
@@ -338,17 +339,17 @@ not correspond exactly to the gem name.
 
 For releases to succeed, new gems MUST include the following:
 
- *  The above configuration entry.
- *  The `*.gemspec` file, with the name matching the gem name.
- *  A `version.rb` file in the standard location, or in a location listed in
+*  The above configuration entry.
+*  The `*.gemspec` file, with the name matching the gem name.
+*  A `version.rb` file in the standard location, or in a location listed in
     the configuration.
- *  A `CHANGELOG.md` file.
- *  A `yard` rake task.
+*  A `CHANGELOG.md` file.
+*  A `yard` rake task.
 
 [cncf-cla]: https://identity.linuxfoundation.org/projects/cncf
 [github-draft]: https://github.blog/2019-02-14-introducing-draft-pull-requests/
 [kube-github-workflow-pr]: https://github.com/kubernetes/community/blob/master/contributors/guide/github-workflow.md#7-create-a-pull-request
-[otel-contributor-guide]: https://github.com/open-telemetry/community/blob/master/CONTRIBUTING.md
-[otel-github-workflow]: https://github.com/open-telemetry/community/blob/master/CONTRIBUTING.md#github-workflow
+[otel-contributor-guide]: https://github.com/open-telemetry/community/blob/main/guides/contributor/README.md
+[otel-github-workflow]: https://github.com/open-telemetry/community/blob/main/guides/contributor/processes.md#workflows
 [otel-lib-guidelines]: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/library-guidelines.md
 [otel-specification]: https://github.com/open-telemetry/opentelemetry-specification

README.md

@@ -33,7 +33,6 @@ Approvers ([@open-telemetry/ruby-approvers](https://github.com/orgs/open-telemet
 - [Andrew Hayworth](https://github.com/ahayworth), Shopify
 - [Sam Handler](https://github.com/plantfansam), Shopify
 - [Robb Kidd](https://github.com/robbkidd), Honeycomb
-- [Kayla Reopelle](https://github.com/kaylareopelle), New Relic
 
 *Find more about the approver role in [community repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#approver).*
 
@@ -43,6 +42,7 @@ Maintainers ([@open-telemetry/ruby-maintainers](https://github.com/orgs/open-tel
 - [Francis Bogsanyi](https://github.com/fbogsany), Shopify
 - [Matthew Wear](https://github.com/mwear), Lightstep
 - [Daniel Azuma](https://github.com/dazuma), Google
+- [Kayla Reopelle](https://github.com/kaylareopelle), New Relic
 
 *Find more about the maintainer role in [community repository](https://github.com/open-telemetry/community/blob/master/community-membership.md#maintainer).*
 
@@ -63,6 +63,7 @@ the [Ruby language](https://www.ruby-lang.org/en/downloads/branches/).
 
 - For more information on OpenTelemetry, visit: <https://opentelemetry.io/>
 - For help or feedback on this project, join us in [GitHub Discussions][discussions-url].
+- For more examples, check [SDK example][examples-github].
 
 ## License
 

api/README.md

@@ -21,7 +21,7 @@ data should depend only on `opentelemetry-api`, deferring the choice of concrete
 
 Install the gem using:
 
-```
+```sh
 gem install opentelemetry-api
 ```
 
@@ -58,7 +58,6 @@ The OpenTelemetry Ruby gems are maintained by the OpenTelemetry-Ruby special int
 
 The `opentelemetry-api` gem is distributed under the Apache 2.0 license. See [LICENSE][license-github] for more information.
 
-
 [opentelemetry-home]: https://opentelemetry.io
 [bundler-home]: https://bundler.io
 [repo-github]: https://github.com/open-telemetry/opentelemetry-ruby

common/README.md

@@ -16,7 +16,7 @@ The `opentelemetry-common` gem provides common helpers for semantic conventions,
 
 Install the gem using:
 
-```
+```sh
 gem install opentelemetry-common
 ```
 

examples/http/README.md

@@ -11,19 +11,21 @@ This is a simple example that demonstrates tracing an HTTP request from client t
 ### Running the example
 
 Install gems
+
 ```sh
 bundle install
 ```
 
 Start the server
+
 ```sh
 ruby server.rb
 ```
 
 In a separate terminal window, run the client to make a single request:
+
 ```sh
 ruby client.rb
 ```
 
 You should see console exporter output for both the client and server sessions.
-