Skip to content

Conversation

@sbryngelson
Copy link
Member

@sbryngelson sbryngelson commented Dec 3, 2025

User description

PR Type

Bug fix, Documentation


Description

  • Fixed broken documentation links to use relative paths

  • Updated case_validator.py link to absolute GitHub URL

  • Added sitemap exclusion to link checker configuration


Diagram Walkthrough

flowchart LR
  A["Documentation Files"] -->|"Convert to relative paths"| B["Local Links"]
  C["case_validator.py Link"] -->|"Convert to GitHub URL"| D["Absolute GitHub Link"]
  E["Link Checker Config"] -->|"Exclude sitemap"| F["Updated .lychee.toml"]
Loading

File Walkthrough

Relevant files
Bug fix
gen_case_constraints_docs.py
Convert case_validator link to GitHub URL                               

toolchain/mfc/gen_case_constraints_docs.py

  • Updated case_validator.py reference link from relative path to
    absolute GitHub URL
  • Changed from ../../toolchain/mfc/case_validator.py to full GitHub
    repository link
+1/-1     
docker.md
Convert absolute documentation links to relative                 

docs/documentation/docker.md

  • Changed Example Cases link from absolute URL to relative path
    examples.md
  • Changed Case Files link from absolute URL to relative path case.md
+2/-2     
getting-started.md
Convert Docker link to relative path                                         

docs/documentation/getting-started.md

  • Changed Docker documentation link from absolute URL to relative path
    docker.md
+1/-1     
Configuration changes
.lychee.toml
Exclude sitemap from link validation                                         

.lychee.toml

  • Added exclusion pattern for sitemap.txt from link checking
  • Added comment explaining sitemap exclusion due to pre-publish
    production URLs
+3/-0     


CodeAnt-AI Description

Use relative documentation links, skip sitemap in link checks, and link validator to GitHub

What Changed

  • Documentation pages now use relative links (e.g., examples.md, case.md, docker.md) so docs resolve correctly in the site and inside the container
  • Generated constraints docs footer now links directly to the validator on GitHub for complete validation logic
  • Link checker configuration ignores sitemap.txt to avoid reporting pre-publish production URLs as broken

Impact

✅ Functional local documentation links in container and site
✅ Fewer link-check failures caused by sitemap
✅ Easier access to validation logic on GitHub

💡 Usage Guide

Checking Your Pull Request

Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.

Talking to CodeAnt AI

Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:

@codeant-ai ask: Your question here

This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.

Example

@codeant-ai ask: Can you suggest a safer alternative to storing this secret?

Preserve Org Learnings with CodeAnt

You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:

@codeant-ai: Your feedback here

This helps CodeAnt AI learn and adapt to your team's coding style and standards.

Example

@codeant-ai: Do not flag unused imports.

Retrigger review

Ask CodeAnt AI to review the PR again, by typing:

@codeant-ai: review

Check Your Repository Health

To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.

Summary by CodeRabbit

  • Documentation

    • Updated documentation links to reference local pages for more consistent navigation.
    • Adjusted generated docs footer to point to the canonical source on GitHub.
  • Chores

    • Updated link-checking configuration to exclude sitemap files from validation.

✏️ Tip: You can customize this high-level summary in your review settings.

Copilot AI review requested due to automatic review settings December 3, 2025 20:27
@codeant-ai
Copy link

codeant-ai bot commented Dec 3, 2025

CodeAnt AI is reviewing your PR.


Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

@qodo-code-review
Copy link
Contributor

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ Recommended focus areas for review

Possible Broken Link

Using a hard-coded GitHub URL to master may break if the default branch changes or the file is moved; consider pinning to a specific commit or constructing the link from repo metadata.

lines.append("review [`case_validator.py`](https://github.com/MFlowCode/MFC/blob/master/toolchain/mfc/case_validator.py) for complete validation logic.\n")
Over-Exclusion Risk

The exclude_path pattern for sitemap may unintentionally skip other files if naming varies across environments; verify the regex and path anchoring match the repo layout.

# Exclude sitemap from link checking (it contains pre-publish production URLs)
exclude_path = ["sitemap\\.txt$"]

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 3, 2025

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Adds an exclude pattern for sitemap.txt to the link-checker config and updates several documentation links to point to local markdown files; also adjusts a generated docs footer link to an absolute GitHub URL.

Changes

Cohort / File(s) Change Summary
Link Checker Configuration
\.lychee\.toml
Added exclude_path = ["**/sitemap.txt"] to exclude sitemap.txt from link checking
Documentation Link Updates
docs/documentation/docker.md, docs/documentation/getting-started.md
Replaced external documentation URLs with local markdown targets (docker.md, examples.md, case.md)
Generated Documentation Footer
toolchain/mfc/gen_case_constraints_docs.py
Rewrote footer link to an absolute GitHub URL pointing to case_validator.py

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~5–15 minutes

  • Check .lychee.toml pattern correctness and intended scope (glob pattern).
  • Verify updated doc links resolve correctly in site build (docs/... paths).
  • Confirm the GitHub URL in the generated footer is the intended canonical target.

Poem

🐰 I hopped through links and paths today,

swapped far-off urls for nearby play.
Sitemap skipped, footer shines anew,
Docs snug in place — a tidy view. ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'fix' is too vague and generic, failing to convey any meaningful information about the specific changes made in the changeset. Consider a more descriptive title like 'Fix documentation links to use relative paths and update link checker configuration' that clearly summarizes the main changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Description check ✅ Passed The description includes well-structured details about changes, a helpful diagram, file walkthrough, and clear impact summary, though some PR template sections remain unchecked.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0501fb0 and c1cd341.

📒 Files selected for processing (1)
  • .lychee.toml (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • .lychee.toml
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (11)
  • GitHub Check: Code Cleanliness Check
  • GitHub Check: Coverage Test on CodeCov
  • GitHub Check: Github (ubuntu, no-mpi, single, no-debug, false)
  • GitHub Check: Github (ubuntu, mpi, debug, false)
  • GitHub Check: Github (macos, mpi, debug, false)
  • GitHub Check: Github (ubuntu, mpi, no-debug, true)
  • GitHub Check: Github (macos, mpi, no-debug, false)
  • GitHub Check: Github (ubuntu, mpi, no-debug, false)
  • GitHub Check: Github (ubuntu, mpi, debug, true)
  • GitHub Check: cubic · AI code reviewer
  • GitHub Check: Build & Publish

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codeant-ai codeant-ai bot added the size:XS This PR changes 0-9 lines, ignoring generated files label Dec 3, 2025
@codeant-ai
Copy link

codeant-ai bot commented Dec 3, 2025

CodeAnt AI finished reviewing your PR.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d8d9e25 and 0501fb0.

📒 Files selected for processing (4)
  • .lychee.toml (1 hunks)
  • docs/documentation/docker.md (1 hunks)
  • docs/documentation/getting-started.md (1 hunks)
  • toolchain/mfc/gen_case_constraints_docs.py (1 hunks)
🧰 Additional context used
🧠 Learnings (2)
📓 Common learnings
Learnt from: CR
Repo: MFlowCode/MFC PR: 0
File: .github/copilot-instructions.md:0-0
Timestamp: 2025-11-24T21:50:16.713Z
Learning: Update in-code comments and documentation (README or docs site) when making significant changes
📚 Learning: 2025-11-24T21:50:46.909Z
Learnt from: CR
Repo: MFlowCode/MFC PR: 0
File: .cursor/rules/mfc-agent-rules.mdc:0-0
Timestamp: 2025-11-24T21:50:46.909Z
Learning: After each successful build step, run focused tests using `./mfc.sh test -j $(nproc) -f EA8FA07E -t 9E2CA336` instead of running all tests

Applied to files:

  • docs/documentation/getting-started.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (20)
  • GitHub Check: Coverage Test on CodeCov
  • GitHub Check: Oak Ridge | Frontier (CCE) (gpu)
  • GitHub Check: Georgia Tech | Phoenix (NVHPC) (gpu)
  • GitHub Check: Georgia Tech | Phoenix (NVHPC) (cpu)
  • GitHub Check: Github (ubuntu, mpi, no-debug, true)
  • GitHub Check: Github (ubuntu, no-mpi, single, no-debug, false)
  • GitHub Check: Github (macos, mpi, debug, false)
  • GitHub Check: Github (ubuntu, mpi, no-debug, false)
  • GitHub Check: Github (macos, mpi, no-debug, false)
  • GitHub Check: Self Hosted (cpu, none, gt)
  • GitHub Check: Self Hosted (gpu, omp, gt)
  • GitHub Check: Self Hosted (gpu, omp, frontier)
  • GitHub Check: Github (ubuntu, mpi, debug, true)
  • GitHub Check: Self Hosted (cpu, none, frontier)
  • GitHub Check: Github (ubuntu, mpi, debug, false)
  • GitHub Check: Self Hosted (gpu, acc, frontier)
  • GitHub Check: Self Hosted (gpu, acc, gt)
  • GitHub Check: Code Cleanliness Check
  • GitHub Check: cubic · AI code reviewer
  • GitHub Check: Build & Publish
🔇 Additional comments (3)
.lychee.toml (1)

18-20: LGTM!

The regex pattern correctly uses double backslash (\\.) to escape the literal dot in TOML string format. The exclusion of sitemap.txt from link checking is appropriate for pre-publish URLs.

docs/documentation/getting-started.md (1)

176-176: Verify that the target file exists.

The link now points to a local file docker.md. Please ensure this file exists in the same directory (docs/documentation/).

docs/documentation/docker.md (1)

41-42: Verify that the target files exist.

The links now point to local files examples.md and case.md. Please ensure these files exist in the docs/documentation/ directory alongside docker.md.

Copilot finished reviewing on behalf of sbryngelson December 3, 2025 20:31
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

This PR standardizes documentation link formats across the repository. The primary goal is to convert absolute URLs (using mflowcode.github.io) to relative paths for better maintainability and portability. Additionally, it configures the link checker to exclude the auto-generated sitemap file that contains pre-publish URLs.

Key Changes:

  • Documentation links converted from absolute URLs to relative markdown paths
  • Link checker configured to skip sitemap.txt validation
  • One exception: Python generator creates GitHub source link instead of relative path

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
toolchain/mfc/gen_case_constraints_docs.py Changed link from relative path to absolute GitHub URL for case_validator.py reference
docs/documentation/getting-started.md Converted Docker documentation link from absolute URL to relative path docker.md
docs/documentation/docker.md Converted two documentation links (Example Cases and Case Files) from absolute URLs to relative paths
.lychee.toml Added exclusion for sitemap.txt from link checking since it contains pre-publish production URLs

Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

2 issues found across 4 files

Prompt for AI agents (all 2 issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="docs/documentation/docker.md">

<violation number="1" location="docs/documentation/docker.md:41">
P1: Broken link: `examples.md` does not exist in the documentation directory. The repository only contains `case.md` but not `examples.md`. This will result in a 404 when users try to navigate to Example Cases.</violation>
</file>

<file name=".lychee.toml">

<violation number="1" location=".lychee.toml:20">
P2: The `exclude_path` pattern uses regex syntax (`\.` and `$`), but Lychee&#39;s `exclude_path` typically expects glob patterns. Consider using a glob pattern like `**/sitemap.txt` instead.</violation>
</file>

Reply to cubic to teach it or ask questions. Re-run a review with @cubic-dev-ai review this PR

@sbryngelson sbryngelson merged commit ab9a1fd into MFlowCode:master Dec 3, 2025
28 of 35 checks passed
@codecov
Copy link

codecov bot commented Dec 3, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 44.16%. Comparing base (d8d9e25) to head (c1cd341).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #1074   +/-   ##
=======================================
  Coverage   44.16%   44.16%           
=======================================
  Files          71       71           
  Lines       20197    20197           
  Branches     1970     1970           
=======================================
  Hits         8921     8921           
  Misses      10148    10148           
  Partials     1128     1128           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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

Labels

Review effort 1/5 size:XS This PR changes 0-9 lines, ignoring generated files

Development

Successfully merging this pull request may close these issues.

1 participant