Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docusaurus] Fix broken links #2720

Closed
wants to merge 3 commits into from
Closed

Conversation

CristianLara
Copy link
Contributor

Motivation

The recent website upgrade moved the location of tutorials and api reference breaking existing links to those. Here we fix those links and also configure Docusaurus to raise an error on broken links in the future.

Test Plan

Docusaurus checks for broken links when creating a production build. Running ./scripts/build_docs.sh -b now results in a clean build with no broken links reported.

Related PRs

tutorials were moved to the /docs/tutorials directory, api reference was moved to an external site
Docusaurus has checks to validate our links are not broken. To make Docusaurus aware of anchors we create we use the <Heading> component they provide.
Would have prevented us from publishing the site with broken links.

For broken anchors we just warn since those still take us to the correct page.
@facebook-github-bot facebook-github-bot added the CLA Signed Do not delete this pull request or issue due to inactivity. label Feb 3, 2025
@facebook-github-bot
Copy link
Contributor

@CristianLara has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

Copy link

codecov bot commented Feb 3, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.99%. Comparing base (8814f68) to head (f4ea814).
Report is 2 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2720   +/-   ##
=======================================
  Coverage   99.98%   99.99%           
=======================================
  Files         203      203           
  Lines       18671    18671           
=======================================
+ Hits        18669    18670    +1     
+ Misses          2        1    -1     

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

Copy link
Contributor

@saitcakmak saitcakmak left a comment

Choose a reason for hiding this comment

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

Thanks! The errors on broken links should be quite helpful going forward!

facebook-github-bot pushed a commit to facebook/Ax that referenced this pull request Feb 3, 2025
Summary:
## Context

Duplicate of same change in botorch: pytorch/botorch#2720

## Motivation

The recent website upgrade moved the location of tutorials and api reference breaking existing links to those. Here we fix those links and also configure Docusaurus to raise an error on broken links in the future.

Pull Request resolved: #3300

Test Plan:
Docusaurus checks for broken links when creating a production build. Running `./scripts/make_docs.sh -b` now results in a clean build with no broken links reported.

## Related PRs
- #3294

Reviewed By: saitcakmak, Balandat

Differential Revision: D69036887

Pulled By: CristianLara

fbshipit-source-id: 1f95fca91a3715e9642da349eb58fa9622d9fdeb
@facebook-github-bot
Copy link
Contributor

@CristianLara merged this pull request in b197bf1.

@saitcakmak saitcakmak deleted the docusaurus-fix-links branch February 3, 2025 16:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed Do not delete this pull request or issue due to inactivity. Merged
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants