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

feature: trigger doc build on release tag #2301

Open
wants to merge 72 commits into
base: main
Choose a base branch
from

Conversation

yuejiaointel
Copy link
Contributor

@yuejiaointel yuejiaointel commented Feb 6, 2025

Description

Hi all,
This PR intends to automate the process to release sklearnex doc. Main changes are in a new file called doc-release.yml. Automation will be triggered if a valid tag is pushed.
Best


PR completeness and readability

  • I have reviewed my changes thoroughly before submitting this pull request.
  • I have commented my code, particularly in hard-to-understand areas.
  • I have resolved any merge conflicts that might occur with the base branch.

Testing

  • I have run it locally and tested the changes extensively.
  • All CI jobs are green or I have provided justification why they aren't.

Copy link

codecov bot commented Feb 6, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Flag Coverage Δ
azure 77.84% <ø> (?)
github 71.03% <ø> (+0.02%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

see 55 files with indirect coverage changes

@yuejiaointel yuejiaointel changed the title feature: trigger doc build on release-test tag feature: trigger doc build on release tag Feb 7, 2025
@david-cortes-intel
Copy link
Contributor

@yuejiaointel Looks like there's something wrong with the "latest" folder in the PR that the bot made in your fork. It should be an identical copy of the new version that got added, but it doesn't contain .html files.

Also, could you enable the "pages" functionality in your fork so that we can see the rendered docs? You can do so in the repository settings:
image

@yuejiaointel
Copy link
Contributor Author

yuejiaointel commented Feb 14, 2025

@yuejiaointel Looks like there's something wrong with the "latest" folder in the PR that the bot made in your fork. It should be an identical copy of the new version that got added, but it doesn't contain .html files.

Also, could you enable the "pages" functionality in your fork so that we can see the rendered docs? You can do so in the repository settings: image

Looking into it rn. Enabled the pages the rendered links should be visible at https://yuejiaointel.github.io/scikit-learn-intelex


html_context = {
"current_version": version,
"project_name": "scikit-learn-intelex",
"switcher_url": switcher_url,
Copy link
Contributor

Choose a reason for hiding this comment

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

@yuejiaointel This line needs to be here for the version switcher to work. Perhaps it could be left with only version "latest" on the main branch, while being re-generated for the "gh-pages" branch.

Copy link
Contributor

Choose a reason for hiding this comment

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

@yuejiaointel It does need to point to a JSON file - sorry about the earlier comment about removing it entirely.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thx, that make sense now, I was wondering why version switcher does not work.

@david-cortes-intel
Copy link
Contributor

@yuejiaointel Looks like there's something wrong with the "latest" folder in the PR that the bot made in your fork. It should be an identical copy of the new version that got added, but it doesn't contain .html files.
Also, could you enable the "pages" functionality in your fork so that we can see the rendered docs? You can do so in the repository settings: image

Looking into it rn. Enabled the pages the rendered links should be visible at https://yuejiaointel.github.io/scikit-learn-intelex

Link throws a 404 by default, unless specifying a previous version like "2025.1":
image

if git fetch origin gh-pages; then
git checkout gh-pages
else
git checkout -b gh-pages
Copy link
Contributor

Choose a reason for hiding this comment

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

I think better to error out with an informative message in this situation. Otherwise it anyway wouldn't let you merge the commits.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good catch! Fixed now it will error out

.github/workflows/docs-release.yml Outdated Show resolved Hide resolved
.github/workflows/docs-release.yml Outdated Show resolved Hide resolved
Copy link
Contributor Author

Choose a reason for hiding this comment

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

These styles are are applied automatic when I save, would it be okay if we keep them?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

So is this file, before some automatic headers are added but they are not correct comment in js and is causing layout.html to not recognize the load_versions function

@yuejiaointel
Copy link
Contributor Author

yuejiaointel commented Feb 15, 2025

@yuejiaointel Looks like there's something wrong with the "latest" folder in the PR that the bot made in your fork. It should be an identical copy of the new version that got added, but it doesn't contain .html files.
Also, could you enable the "pages" functionality in your fork so that we can see the rendered docs? You can do so in the repository settings: image

Looking into it rn. Enabled the pages the rendered links should be visible at https://yuejiaointel.github.io/scikit-learn-intelex

Link throws a 404 by default, unless specifying a previous version like "2025.1": image

Fixed! The version_switcher.js is having some wrong style comment on top and is causing layout html to not recognize the load_versions function. Now link and version switcher should work

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.

3 participants