Skip to content

CI: Update actions - #1360

Merged
RytoEX merged 3 commits into
obsproject:masterfrom
RytoEX:update-actions
Oct 2, 2026
Merged

RytoEX merged 3 commits into
obsproject:masterfrom
RytoEX:update-actions

Conversation

@RytoEX

@RytoEX RytoEX commented Oct 2, 2026 •

Copy link
Copy Markdown
Member

Description

Add alt text to images in README to avoid linter failure. @Warchamp7 happy to defer to you if you want to write more descriptive alt text.


@tt2468 may need to weigh in on the change to documentation generation, because I may have missed some nuance there.

Do not register "categories" as global fragments when generating documentation.

This is causing a name collision on category names when building header links in the documentation. The "category" names are being registered in get_fragment even though the header patterns for Events and Requests are:

  • ## {} Events
  • ## {} Requests

As a result, when processing Requests, the shared categories between Events and Requests, such as "General" and "Config", end up with "deduplicated" names for the header links such as:

  • general-1-requests
  • config-1-requests

This results in broken links in the Requests Table of Contents.

Since the categories themselves are not used to build links anywhere, we can set the register param in those get_fragment(category) calls to False and only register the requestType and eventType fragments.

Note: this looks like a missed change from 947f261.


Finally, update and pin nosborn/github-action-markdown-cli to v3.5.0 as originally intended now that all linter failures have been addressed.

Motivation and Context

Update CI actions. Address linter failures.

How Has This Been Tested?

Tested on my CI.

Types of changes

  • CI

Checklist:

  • I have read the Contributing Guidelines.
  • All commit messages are properly formatted and commits squashed where appropriate.
  • My code is not on master or a release/* branch.
  • The code has been tested.
  • I have included updates to all appropriate documentation.

@RytoEX RytoEX self-assigned this Oct 2, 2026
Comment thread README.md

@Fenrirthviti Fenrirthviti left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

Alt text guidance seems to boil down to "describe the thing" and this looks fine.

@Fenrirthviti Fenrirthviti left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pending internal conversation on the OC contributors list in the readme.

Leaving a review comment to prevent accidental merge.

@RytoEX
RytoEX marked this pull request as draft October 2, 2026 20:02
RytoEX added 3 commits October 2, 2026 17:28
This is causing a name collision on category names when building header
links in the documentation. The "category" names are being registered in
get_fragment even though the header patterns for Events and Requests are:
 * `## {} Events`
 * `## {} Requests`

As a result, when processing Requests, the shared categories between
Events and Requests, such as "General" and "Config", end up with
"deduplicated" names for the header links such as:
 * general-1-requests
 * config-1-requests

This results in broken links in the Requests Table of Contents.

Since the categories themselves are not used to build links anywhere, we
can set the register param in those get_fragment(category) calls to
False and only register the requestType and eventType fragments.
Pin the action to the commit for v3.5.0.

Also, update the config to ignore introduction.md because its links will
always be broken as it is a partial file used to generate the complete
documentation.
@RytoEX

RytoEX commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

Pending internal conversation on the OC contributors list in the readme.

Leaving a review comment to prevent accidental merge.

Per off-thread discussion, left the OC contributors lists as-is, but added alt text.

@RytoEX
RytoEX marked this pull request as ready for review October 2, 2026 21:29
@RytoEX
RytoEX requested a review from Fenrirthviti October 2, 2026 21:43
@RytoEX
RytoEX merged commit 4eac0d1 into obsproject:master Oct 2, 2026
1 check passed
@RytoEX
RytoEX deleted the update-actions branch October 2, 2026 21:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants