ci: prepare flint next-release lint setup (#2782)

Author: zeitlinger

.github/config/.rumdl.toml

@@ -0,0 +1,15 @@
+# See https://rumdl.dev/
+# and https://rumdl.dev/rules/
+[MD004]
+enabled = true
+style = "asterisk"
+
+[MD013]
+enabled = true
+line-length = 120
+code-blocks = false
+tables = false
+
+[MD060]
+enabled = true
+style = "aligned"

.github/config/lychee.toml

@@ -12,6 +12,8 @@ include_fragments = "full"
 exclude = [
   # excluding links to pull requests and issues is done for performance
   "^https://github.com/open-telemetry/opentelemetry-java-contrib/(issues|pull)/\\d+$",
+  # developer.ibm.com intermittently returns 500 for MQ downloads
+  "^https://developer\\.ibm\\.com/articles/mq-downloads/$",
   # groovy-lang.org is frequently unreachable / times out
   "^https?://[^/]*groovy-lang\\.org",
 ]

.github/copilot-instructions.md

@@ -8,26 +8,26 @@ This repository provides observability instrumentation for Java applications.
 
 **PRIORITY**: Verify that all code changes follow the [Style Guide](../docs/style-guide.md). Check:
 
-- Code formatting (auto-formatting, static imports, class organization)
-- Java language conventions (`final` usage, `@Nullable` annotations, `Optional` usage)
-- Performance constraints (hot path allocations)
-- Implementation patterns (SPI registration, configuration conventions)
-- Gradle conventions (Kotlin DSL, plugin usage, module naming)
-- Documentation standards (README files, deprecation processes)
+* Code formatting (auto-formatting, static imports, class organization)
+* Java language conventions (`final` usage, `@Nullable` annotations, `Optional` usage)
+* Performance constraints (hot path allocations)
+* Implementation patterns (SPI registration, configuration conventions)
+* Gradle conventions (Kotlin DSL, plugin usage, module naming)
+* Documentation standards (README files, deprecation processes)
 
 ### Critical Areas
 
-- **Public APIs**: Changes affect downstream users and require careful review
-- **Performance**: Instrumentation must have minimal overhead
-- **Thread Safety**: Ensure safe concurrent access patterns
-- **Memory Management**: Prevent leaks and excessive allocations
+* **Public APIs**: Changes affect downstream users and require careful review
+* **Performance**: Instrumentation must have minimal overhead
+* **Thread Safety**: Ensure safe concurrent access patterns
+* **Memory Management**: Prevent leaks and excessive allocations
 
 ### Quality Standards
 
-- Proper error handling with appropriate logging levels
-- OpenTelemetry specification and semantic convention compliance
-- Resource cleanup and lifecycle management
-- Comprehensive unit tests for new functionality
+* Proper error handling with appropriate logging levels
+* OpenTelemetry specification and semantic convention compliance
+* Resource cleanup and lifecycle management
+* Comprehensive unit tests for new functionality
 
 ### Test suites
 
@@ -63,4 +63,4 @@ When implementing changes or new features:
 1. Follow all [Style Guide](../docs/style-guide.md) conventions and the Code Review Priorities above
 2. Run tests to ensure they still pass (use `./gradlew test` and `./gradlew integrationTest` as needed)
 3. **Always run `./gradlew spotlessApply`** after making code changes to ensure proper formatting
-4. Run markdown lint to ensure it still passes: `mise run lint:markdown`
+4. Run linting to ensure it still passes: `mise run lint`

.github/renovate.json5

@@ -1,6 +1,7 @@
 {
   $schema: 'https://docs.renovatebot.com/renovate-schema.json',
   extends: [
+    "github>grafana/flint#v0.21.0",
     'config:best-practices',
     'helpers:pinGitHubActionDigestsToSemver',
     'customManagers:githubActionsVersions',

.github/repository-settings.md

@@ -8,32 +8,32 @@ private admin repo.
 
 [The admin repo doesn't currently support tracking merge queue settings.]
 
-- Require merge queue: CHECKED
-  - Build concurrency: 5
-  - Maximum pull requests to build: 5
-  - Minimum pull requests to merge: 1, or after 5 minutes
-  - Maximum pull requests to merge: 5
-  - Only merge non-failing pull requests: CHECKED
-  - Status check timeout: 60 minutes
+* Require merge queue: CHECKED
+  * Build concurrency: 5
+  * Maximum pull requests to build: 5
+  * Minimum pull requests to merge: 1, or after 5 minutes
+  * Maximum pull requests to merge: 5
+  * Only merge non-failing pull requests: CHECKED
+  * Status check timeout: 60 minutes
 
 ## Secrets and variables > Actions
 
 ### Repository secrets
 
-- `GPG_PASSWORD` - stored in OpenTelemetry-Java 1Password
-- `GPG_PRIVATE_KEY` - stored in OpenTelemetry-Java 1Password
-- `SONATYPE_GUIDE_PAT` - owned by [@trask](https://github.com/trask)
-- `SONATYPE_KEY` - owned by [@trask](https://github.com/trask)
-- `SONATYPE_USER` - owned by [@trask](https://github.com/trask)
+* `GPG_PASSWORD` - stored in OpenTelemetry-Java 1Password
+* `GPG_PRIVATE_KEY` - stored in OpenTelemetry-Java 1Password
+* `SONATYPE_GUIDE_PAT` - owned by [@trask](https://github.com/trask)
+* `SONATYPE_KEY` - owned by [@trask](https://github.com/trask)
+* `SONATYPE_USER` - owned by [@trask](https://github.com/trask)
 
 ### Organization secrets
 
-- `CODECOV_TOKEN`
-- `DEVELOCITY_ACCESS_KEY` (scoped only to Java repos)
-- `FOSSA_API_KEY`
-- `OTELBOT_PRIVATE_KEY`
+* `CODECOV_TOKEN`
+* `DEVELOCITY_ACCESS_KEY` (scoped only to Java repos)
+* `FOSSA_API_KEY`
+* `OTELBOT_PRIVATE_KEY`
 
 ### Organization variables
 
-- `OSSF_SCORECARD_APP_ID`
-- `OTELBOT_APP_ID`
+* `OSSF_SCORECARD_APP_ID`
+* `OTELBOT_APP_ID`

.markdownlint.yaml

@@ -33,20 +33,20 @@ To run the tests:
 
 ## Markdown linting
 
-This repository uses [markdownlint](https://github.com/DavidAnson/markdownlint) via `markdownlint-cli2` managed by [mise](https://github.com/jdx/mise).
+This repository uses [rumdl](https://rumdl.dev/) via [Flint](https://github.com/grafana/flint), managed by [mise](https://github.com/jdx/mise).
 
-To check all Markdown files:
+To check Markdown and links:
 
 ```bash
-mise run lint:markdown
+mise run lint
 ```
 
 (note: Windows users may need to run `mise install` first)
 
-To automatically fix fixable issues:
+To automatically fix fixable Markdown issues:
 
 ```bash
-mise run lint:markdown --fix
+mise run lint:fix
 ```
 
 ## Snapshot Builds
@@ -63,15 +63,15 @@ See [Style Guide](docs/style-guide.md).
 
 When submitting a pull request, please ensure that you:
 
-- Clearly describe the change and its motivation
-- Mention any breaking changes
-- Include tests for new functionality
-- Follow the [Style Guide](docs/style-guide.md)
+* Clearly describe the change and its motivation
+* Mention any breaking changes
+* Include tests for new functionality
+* Follow the [Style Guide](docs/style-guide.md)
 
 ## Getting Help
 
 If you need assistance or have questions:
 
-- Post on the [#otel-java](https://cloud-native.slack.com/archives/C014L2KCTE3) Slack channel
-- [Open an issue](https://github.com/open-telemetry/opentelemetry-java-contrib/issues/new/choose) in
+* Post on the [#otel-java](https://cloud-native.slack.com/archives/C014L2KCTE3) Slack channel
+* [Open an issue](https://github.com/open-telemetry/opentelemetry-java-contrib/issues/new/choose) in
   this repository

.mise/tasks/lint/markdown.sh

@@ -8,14 +8,14 @@
 
 This project is intended to provide helpful libraries and standalone OpenTelemetry-based utilities that don't fit
 the express scope of the [OpenTelemetry Java](https://github.com/open-telemetry/opentelemetry-java) or
-[Java Instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) projects.  If you need an
+[Java Instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) projects. If you need an
 easier way to bring observability to remote JVM-based applications and workflows that isn't easily satisfied by an SDK
 feature or via instrumentation, this project is hopefully for you.
 
 ## Provided Libraries
 
 | Status* | Library                                                           |
-|---------|-------------------------------------------------------------------|
+| ------- | ----------------------------------------------------------------- |
 | beta    | [AWS Resources](./aws-resources/README.md)                        |
 | stable  | [AWS X-Ray SDK Support](./aws-xray/README.md)                     |
 | alpha   | [AWS X-Ray Propagator](./aws-xray-propagator/README.md)           |
@@ -47,39 +47,38 @@ feature or via instrumentation, this project is hopefully for you.
 To reach stable status, the library needs to have stable APIs, stable semantic conventions, and be production ready.
 On reaching stable status, the `otel.stable` value in `gradle.properties` should be set to `true`.
 Note that currently all the libraries are released together with the version of this repo, so breaking changes (after stable
-status is reached) would bump the major version of all libraries together. This could get complicated so `stable` has a high bar.
+status is reached) would bump the major version of all libraries together.
+This could get complicated, so `stable` has a high bar.
 
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ### Maintainers
 
-- [Jack Berg](https://github.com/jack-berg), Grafana Labs
-- [Jason Plumb](https://github.com/breedx-splk), Splunk
-- [Jay DeLuca](https://github.com/jaydeluca), Grafana Labs
-- [Lauri Tulmin](https://github.com/laurit), Splunk
-- [Trask Stalnaker](https://github.com/trask), Microsoft
+* [Jack Berg](https://github.com/jack-berg), Grafana Labs
+* [Jason Plumb](https://github.com/breedx-splk), Splunk
+* [Jay DeLuca](https://github.com/jaydeluca), Grafana Labs
+* [Lauri Tulmin](https://github.com/laurit), Splunk
+* [Trask Stalnaker](https://github.com/trask), Microsoft
 
 For more information about the maintainer role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#maintainer).
 
 ### Approvers
 
-- [Gregor Zeitlinger](https://github.com/zeitlinger), Grafana Labs
-- [John Watson](https://github.com/jkwatson), Sublime Security
+* [Gregor Zeitlinger](https://github.com/zeitlinger), Grafana Labs
+* [John Watson](https://github.com/jkwatson), Sublime Security
 
 For more information about the approver role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#approver).
 
 ### Emeritus maintainers
 
-- [Mateusz Rzeszutek](https://github.com/mateuszrzeszutek)
-- [Nikita Salnikov-Tarnovski](https://github.com/iNikem)
-- [Ryan Fitzpatrick](https://github.com/rmfitzpatrick)
+* [Mateusz Rzeszutek](https://github.com/mateuszrzeszutek)
+* [Nikita Salnikov-Tarnovski](https://github.com/iNikem)
+* [Ryan Fitzpatrick](https://github.com/rmfitzpatrick)
 
 For more information about the emeritus role, see the [community repository](https://github.com/open-telemetry/community/blob/main/guides/contributor/membership.md#emeritus-maintainerapprovertriager).
 
-### Thanks to all of our contributors!
+### Thanks to all of our contributors
 
-<a href="https://github.com/open-telemetry/opentelemetry-java-contrib/graphs/contributors">
-  <img alt="Repo contributors" src="https://contrib.rocks/image?repo=open-telemetry/opentelemetry-java-contrib" />
-</a>
+[![Repo contributors](https://contrib.rocks/image?repo=open-telemetry/opentelemetry-java-contrib)](https://github.com/open-telemetry/opentelemetry-java-contrib/graphs/contributors)

CONTRIBUTING.md

@@ -4,7 +4,7 @@ This module contains AWS resource detectors including Beanstalk, EC2, ECS, EKS,
 
 ## Component owners
 
-- [Lei Wang](https://github.com/wangzlei), AWS
-- [Prashant Srivastava](https://github.com/srprash), AWS
+* [Lei Wang](https://github.com/wangzlei), AWS
+* [Prashant Srivastava](https://github.com/srprash), AWS
 
 Learn more about component owners in [component_owners.yml](../.github/component_owners.yml).