Skip to content

[skip changelog] Add link check exclusions for broken generated Protocol Buffer doc links#3221

Merged
per1234 merged 1 commit into
arduino:masterfrom
per1234:proto-doc-exclude
Jun 19, 2026
Merged

[skip changelog] Add link check exclusions for broken generated Protocol Buffer doc links#3221
per1234 merged 1 commit into
arduino:masterfrom
per1234:proto-doc-exclude

Conversation

@per1234

@per1234 per1234 commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Please check if the PR fulfills these requirements

See how to contribute

  • The PR has no duplicates (please search among the Pull Requests
    before creating one)
  • The PR follows
    our contributing guidelines
  • [N/A] Tests for the changes have been added (for bug fixes / features)
  • [N/A] Docs have been added / updated (for bug fixes / features)
  • [N/A] UPGRADING.md has been updated with a migration guide (for breaking changes)
  • [N/A] configuration.schema.json updated if new parameters are added.

What kind of change does this PR introduce?

Bug fix

What is the current behavior?

Documentation of the Protocol Buffers interface is automatically generated from the project source code.

Unfortunately the documentation generator produces some broken links. These cause the project infrastructure's link checker to fail:

ERROR: 104 dead links found in ./docs/rpc/commands.md !
[✖] #google-protobuf-Any → Status: 404
[✖] #google-rpc-Status → Status: 404

What is the new behavior?

It will not be feasible to fix these links, so the only available resolution for those link check failures is to configure exclusions.

Does this PR introduce a breaking change, and is titled accordingly?

No breaking change.

@per1234 per1234 requested a review from cmaglie June 19, 2026 00:01
@per1234 per1234 self-assigned this Jun 19, 2026
@per1234 per1234 added topic: documentation Related to documentation for the project topic: infrastructure Related to project infrastructure type: imperfection Perceived defect in any part of project labels Jun 19, 2026
@CLAassistant

CLAassistant commented Jun 19, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

…col Buffer doc links

Documentation of the Protocol Buffers interface is automatically generated from the project source code.

Unfortunately the documentation generator produces some broken links. These cause the project infrastructure's link
checker to fail:

```
ERROR: 104 dead links found in ./docs/rpc/commands.md !
[✖] #google-protobuf-Any → Status: 404
[✖] #google-rpc-Status → Status: 404
```

It will not be feasible to fix these links, so the only available resolution for those link check failures is to
configure exclusions.
@per1234 per1234 force-pushed the proto-doc-exclude branch from eca2e3d to 4041ee6 Compare June 19, 2026 00:28
@arduino arduino deleted a comment from CLAassistant Jun 19, 2026
@per1234 per1234 merged commit 4e785d7 into arduino:master Jun 19, 2026
5 of 6 checks passed
@per1234 per1234 deleted the proto-doc-exclude branch June 19, 2026 08:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

topic: documentation Related to documentation for the project topic: infrastructure Related to project infrastructure type: imperfection Perceived defect in any part of project

3 participants