Skip to content

Fix Minor Docs Issues#741

Open
Scienfitz wants to merge 2 commits intoemdgroup:mainfrom
Scienfitz:docs/fixes
Open

Fix Minor Docs Issues#741
Scienfitz wants to merge 2 commits intoemdgroup:mainfrom
Scienfitz:docs/fixes

Conversation

@Scienfitz
Copy link
Collaborator

Fixes #727 and #578

Changed

  • added a html anchor to the README, this makes the link clickable on GitHub and has no influence on the deployed page (is not visible there)
  • Update build script to not do linebreaks if they are on commented files

On my fork this has fixed the issues:

It does not remove the visible (installation)= from the README but since there is no net loss this solution should be accepted as Issue closing.

Scienfitz and others added 2 commits February 7, 2026 18:28
Long headings in example files were being wrapped by the build script, causing them to be rendered incorrectly in the documentation.
This commit modifies `docs/scripts/build_examples.py` to prevent wrapping of lines that start with `#` (headings).

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
@Scienfitz Scienfitz self-assigned this Feb 7, 2026
@Scienfitz Scienfitz added the documentation Improvements or additions to documentation label Feb 7, 2026
@Scienfitz Scienfitz requested a review from AVHopp as a code owner February 7, 2026 19:38
Copilot AI review requested due to automatic review settings February 7, 2026 19:38
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Resolves minor documentation usability issues by improving anchor linking in the README and preventing unwanted line-wrapping in generated example docs.

Changes:

  • Add an explicit HTML anchor in README.md to make the installation section link reliably clickable on GitHub.
  • Update the examples build script to avoid wrapping long lines that are comments.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/scripts/build_examples.py Skips automatic line wrapping for comment lines to prevent formatting issues in generated docs.
README.md Adds a stable HTML anchor for the installation section to improve linkability on GitHub.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Long titles are not rendered correctly in the existing docs

2 participants