Merge branch 'main' into update-svrnm-affiliation-and-areas-of-interest

Author: mx-psi

.cspell.yaml

@@ -39,6 +39,7 @@ words:
     - grafana
     - Hostmetrics
     - hostmetricsreceiver
+    - Instrgen
     - jemmic
     - keptn
     - kubecon
@@ -67,6 +68,7 @@ words:
     - Sysplex
     - acramsay
     - adot
+    - agentmanwg
     - alolita
     - amye
     - andré
@@ -110,6 +112,7 @@ words:
     - dyla
     - dynatrace
     - easycla
+    - ebpf
     - eiffel
     - emea
     - endsigs
@@ -124,6 +127,7 @@ words:
     - heptio
     - hongalex
     - horovits
+    - instrgen
     - jackjia
     - jaglowski
     - javaagent
@@ -146,6 +150,7 @@ words:
     - logz
     - lucavallin
     - lukas
+    - lycheeverse
     - magnusbaeck
     - maintainership
     - mancuso
@@ -162,6 +167,8 @@ words:
     - mkorbi
     - molkova
     - msomasu
+    - MSYS
+    - PATHCONV
     - mtwo
     - mwear
     - najaryan
@@ -173,16 +180,19 @@ words:
     - nikimanoledaki
     - novotny
     - observiq
+    - opamp
     - OpenLIT
     - opentelemetry
     - opentelemetrybot
     - otel
     - otel-agentmanwg
     - otel-comms
     - otel-ebpf
+    - otelbot
     - otep
     - otlp
     - outreachy
+    - Packagist
     - Prometheus
     - paixão
     - pająk
@@ -191,8 +201,10 @@ words:
     - proto
     - protos
     - pytest
+    - Quesma
     - raesene
     - reiley
+    - rolldice
     - ruech
     - runtimes
     - rynn
@@ -235,5 +247,6 @@ words:
     - triager
     - triagers
     - teamcity
+    - uninstrumented
     - vtex
     - yahn

.github/ISSUE_TEMPLATE/gc_member_onboarding.md

@@ -33,7 +33,7 @@ The new member must:
    2. [Concepts](https://opentelemetry.io/docs/concepts/)
    3. [Specification](https://opentelemetry.io/docs/specs/otel/)
 2. Have read and agreed to comply with the
-   [OpenTelemetry Governance Committee Charter](https://github.com/open-telemetry/community/blob/main/governance-charter.md)
+   [OpenTelemetry Governance Committee Charter](../../governance-charter.md)
    as per requirements to stand for election.
 3. Have an email address, Google account, and GitHub account and is willing
    to share those details with other GC members.

.github/repository-settings.md

@@ -18,6 +18,7 @@ settings](../docs/how-to-configure-new-repository.md#repository-settings).
   * EasyCLA
   * spelling-check
   * table-check
+  * toc-check
 
 ### `**/**`
 

.github/scripts/markdown-link-check-config.json

@@ -0,0 +1,20 @@
+name: FOSSA scanning
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  fossa:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+
+      - uses: fossas/fossa-action@93a52ecf7c3ac7eb40f5de77fd69b1a19524de94 # v1.5.0
+        with:
+          api-key: ${{secrets.FOSSA_API_KEY}}
+          team: OpenTelemetry

.github/scripts/markdown-link-check-with-retry.sh

@@ -0,0 +1,13 @@
+name: Table of contents checking
+
+on:
+  pull_request:
+
+jobs:
+  toc-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: check TOC in assets.md
+        run: make markdown-toc-check

.github/workflows/fossa.yml

@@ -0,0 +1,16 @@
+include_fragments = true
+
+accept = ["200..=299", "401", "403"]
+
+exclude = [
+    "https://slack.com/help/articles/8328303095443-Understand-Channel-Managers-in-Slack",
+    "https://observe2020.io",
+    "https://servicenow.com",
+    # excluding links to user profiles is done for performance
+    # because there are a lot of links to user profiles in this repository
+    # and GitHub extra throttles access to user profile pages
+    "^https://github.com/[^/]+$"
+]
+
+# better to be safe and avoid failures
+max_retries = 6

.github/workflows/toc-check.yml

@@ -2,8 +2,7 @@
 
 ## Document purpose
 
-OpenTelemetry has a [Code of
-Conduct](https://github.com/open-telemetry/community/blob/master/code-of-conduct.md)
+OpenTelemetry has a [Code of Conduct](./code-of-conduct.md)
 where maintainers and community members pledge to foster a welcoming and open
 community. The code of conduct cites examples of unacceptable behavior by
 participants – like harassment, trolling or personal attacks – that would lead to

.lychee.toml

@@ -0,0 +1,25 @@
+# Contributing
+
+Welcome to OpenTelemetry community repository!
+
+Before you start - see OpenTelemetry general [contributing](guides/contributor/README.md)
+requirements and recommendations.
+
+## Updating SIG information on the README.md
+
+The SIG tables on the [README.md](README.md) page are generated from [`sigs.yml`](sigs.yml).
+
+To regenerate those tables after updating any `sigs.yml` content, run:
+
+```bash
+make table-generation
+```
+
+## Updating the assets.md page
+
+The [`assets.md`](assets.md) page has an auto-generated table of contents.
+To regenerate the table of contents after updating any headings on that page, run:
+
+```bash
+make markdown-toc
+```

COMMUNICATION.md

@@ -1,11 +1,13 @@
 # All documents to be used in spell check.
 ALL_DOCS := $(shell find . -type f -name '*.md' -not -path './.github/*' -not -path './node_modules/*' | sort)
 
+# This is needed to make the /repo paths below work in Windows Git Bash
+export MSYS_NO_PATHCONV=1
+
 .PHONY: table-generation
 table-generation:
 	docker run --rm -v ${PWD}:/repo -w /repo python:3-alpine python ./scripts/update-sig-tables.py --install;
 
-
 validate-sigs:
 	docker run --rm -v ${PWD}:/repo -w /repo python:3-alpine python ./scripts/validate-sigs.py --install;
 
@@ -14,13 +16,13 @@ table-check:
 
 .PHONY: markdown-link-check
 markdown-link-check:
-	@if ! npm ls markdown-link-check; then npm install; fi
-	find . -type f \
-		-name '*.md' \
-		-not -path './node_modules/*' \
-		-not -path './elections/*/governance-committee-election.md' \
-		-not -path './elections/*/governance-committee-candidates.md' \
-		| xargs .github/scripts/markdown-link-check-with-retry.sh
+	docker run --rm \
+		--mount 'type=bind,source=$(PWD),target=/home/repo' \
+		lycheeverse/lychee \
+		--config home/repo/.lychee.toml \
+		--root-dir /home/repo \
+		--verbose \
+		home/repo
 
 # This target runs markdown-toc on all files that contain
 # a pair of comments <!-- toc --> and <!-- tocstop -->.
@@ -35,3 +37,6 @@ markdown-toc:
 			echo markdown-toc: no TOC markers, skipping $$f; \
 		fi; \
 	done
+
+markdown-toc-check: markdown-toc
+	git diff --exit-code ':*.md' || (echo 'Generated markdown Table of Contents is out of date, please run "make markdown-toc" and commit the changes in this PR.' && exit 1)