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

updated docsite workflow #1624

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

Conversation

Veer0x1
Copy link

@Veer0x1 Veer0x1 commented Jan 29, 2025

Proposed changes

Added automated documentation deployment pipeline using GitHub Actions. This workflow automatically builds and deploys documentation when changes are pushed to main branch or when new version tags are created.

Fixes #1593


Types of changes

  • Bug fix
  • New feature added
  • Documentation Update

Please make sure to follow these points

  • I have read the contributing guidelines.
  • I have performed a self-review of my own code or work.
  • I have commented my code, particularly in hard-to-understand areas.
  • My changes generates no new warnings.
  • My Pull Request title is in format < issue name > eg Added links in the documentation.
  • I have added tests that prove my fix is effective or that my feature works.
  • My changes have sufficient code coverage (unit, integration, e2e tests).

Copy link
Contributor

@EnriqueL8 EnriqueL8 left a comment

Choose a reason for hiding this comment

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

Sorry @Veer0x1 we had to force push a few commits into main to clean up some large files so this PR needs to be rebased on that to remove the extra commits

Signed-off-by: Veer0x1 <[email protected]>
Signed-off-by: Ry Jones <[email protected]>
@Veer0x1
Copy link
Author

Veer0x1 commented Jan 31, 2025

Sorry @Veer0x1 we had to force push a few commits into main to clean up some large files so this PR needs to be rebased on that to remove the extra commits

done

Copy link
Contributor

@EnriqueL8 EnriqueL8 left a comment

Choose a reason for hiding this comment

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

Sorry @Veer0x1 the behavior might not be the one we intend to consume

jobs:
build:
deplou:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
deplou:
deploy:

Comment on lines +41 to +47
# Strip "v" prefix from tag name
[[ "${{ github.ref }}" == "refs/tags/"* ]] && ALIAS=$(echo $VERSION | sed -e 's/^v//')
# If building from main, use latest as ALIAS
[ "$VERSION" == "main" ] && ALIAS=latest
echo $VERSION $ALIAS
mike deploy --push --update-aliases $VERSION $ALIAS
mike set-default latest
Copy link
Contributor

Choose a reason for hiding this comment

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

Sorry so this issue was about reusing that workflow but I incorrectly made an assumption and now I've realized that this is not the behavior we want. In the previous version, we set latest to be the latest released tag. So as of today v1.3.2 but this new change would make main be latest. Latest is also the default when users land on the page so I think it should stay the newest version as that is version that users should consume

Copy link
Contributor

Choose a reason for hiding this comment

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

Based on reading the mike docs https://github.com/jimporter/mike?tab=readme-ov-file I think keeping latest to point a released version instead of main is the correct behavior in my opinion

Copy link
Contributor

Choose a reason for hiding this comment

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

FYI @tkuhrt as I know you built this workflow and the plan was to re-use some code instead of FireFly keeping its own. We could do a GitHub dispatch action in the future but based on the above behavior might make sense to keep our own workflow

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.

Use the template doc workflow
2 participants