Skip to content

fix: Omit private methods from doc ToC#275

Merged
tomasz-blasz merged 1 commit intonextfrom
omit-private-methods-toc
Sep 15, 2025
Merged

fix: Omit private methods from doc ToC#275
tomasz-blasz merged 1 commit intonextfrom
omit-private-methods-toc

Conversation

@alkalinecoffee
Copy link
Contributor

@alkalinecoffee alkalinecoffee commented Sep 11, 2025

The documentation portal has an issue where HTML tags are being escaped/not properly handled by Jekyll. I don't think this is an issue with Jekyll, but rather in how we're mixing markdown with HTML in a non-standard way (this wasn't tested against the Comcast doc portal yet).

This mainly affects the private methods/events, which were intended to be "hidden" behind a dropdown in the Table of Contents.e.g.:

Screenshot 2025-09-11 at 12 02 28 PM

This changes updates the logic to remove the hidden methods/broken HTML, and instead replace it with a link to the private methods/events section.

Screenshot 2025-09-11 at 12 02 43 PM

Copy link
Contributor

@tomasz-blasz tomasz-blasz left a comment

Choose a reason for hiding this comment

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

Looks fine to me, but I'd like @vladimir-rangelov to review it before we merge.

@tomasz-blasz tomasz-blasz merged commit 296a066 into next Sep 15, 2025
7 checks passed
@tomasz-blasz tomasz-blasz deleted the omit-private-methods-toc branch September 15, 2025 11:42
aczs pushed a commit that referenced this pull request Sep 15, 2025
# [3.2.0-next.18](v3.2.0-next.17...v3.2.0-next.18) (2025-09-15)

### Bug Fixes

* Omit private methods from doc ToC ([#275](#275)) ([296a066](296a066))
@aczs
Copy link
Collaborator

aczs commented Sep 15, 2025

🎉 This PR is included in version 3.2.0-next.18 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants