Skip to content

chore: publish the Rust docs to Netlify #180

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

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

chore: publish the Rust docs to Netlify #180

wants to merge 29 commits into from

Conversation

collins-w
Copy link
Contributor

Summary

chore: publish rust docs to Netlify

Testing Process

Checklist

  • Add a reference to related issues in the PR description.
  • Add unit tests if applicable.

Copy link
Contributor

@tirumerla tirumerla left a comment

Choose a reason for hiding this comment

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

Requested a minor change

run: |
MAJOR_MINOR="${{ steps.validate_tag.outputs.MAJOR }}-${{ steps.validate_tag.outputs.MINOR }}"
echo "Major and minor version extracted: $MAJOR_MINOR"
sed -i '' -E "s|(https://)[^/]*openzeppelin-relayer\.netlify\.app|\1docs-v${MAJOR_MINOR}--openzeppelin-relayer.netlify.app|g" docs/modules/ROOT/nav.adoc
Copy link
Contributor

@tirumerla tirumerla May 5, 2025

Choose a reason for hiding this comment

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

Lets make sure to change it to release-v* version on push to release branch and then on push to docs branch change it to docs-v*

Comment on lines 98 to 101
major_minor_version=$(echo "${{ steps.get_version.outputs.version }}" | cut -d'.' -f1,2)
echo "Major and minor version extracted: $major_minor_version"
sed -i '' -E "s|(https://)[^/]*openzeppelin-relayer\.netlify\.app|\1release-v${major_minor_version}--openzeppelin-relayer.netlify.app|g" docs/modules/ROOT/nav.adoc
Copy link
Contributor

Choose a reason for hiding this comment

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

Why not add this in "on push" to release-v* branch add condition to check if it's release branch version prefix url for netlify if not update it? This workflow we can keep just strictly to create a release branch

Copy link

codecov bot commented May 6, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 87.2%. Comparing base (6fd59bc) to head (45bc8ca).
Report is 12 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##            main    #180     +/-   ##
=======================================
+ Coverage   86.6%   87.2%   +0.6%     
=======================================
  Files        126     131      +5     
  Lines      28000   29747   +1747     
=======================================
+ Hits       24265   25969   +1704     
- Misses      3735    3778     +43     
Flag Coverage Δ
integration 1.0% <ø> (-0.1%) ⬇️
properties <0.1% <ø> (-0.1%) ⬇️
unittests 87.3% <ø> (+0.6%) ⬆️

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

☔ 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.

id: get_branch
run: |
echo "branch=${{ inputs.branch }}" >> $GITHUB_OUTPUT
- name: Update the technical docs link in nav.adoc
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is it possible to use some kind of redirection instead of updating nav.adoc file every time?

Copy link
Collaborator

Choose a reason for hiding this comment

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

We will have different deployment url with every deploy?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah, each deploy will have a different prefix on the url(e.g release-v1, release-v2, docs-v1 etc)

Copy link
Collaborator

Choose a reason for hiding this comment

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

Can we do it without modifying file?

Maybe to always point to single url and in the background to redirect?

@@ -1,6 +1,6 @@
//! This module contains the status-related functionality for EVM transactions.
//! It includes methods for checking transaction status, determining when to resubmit
//! or replace transactions with NOOPs, and updating transaction status in the repository.
//! or replace transactions with NOPs, and updating transaction status in the repository.
Copy link
Collaborator

Choose a reason for hiding this comment

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

typo, lets revert this one

@@ -3,4 +3,4 @@
* xref:api_reference.adoc[API Reference]
* xref:structure.adoc[Project Structure]
* xref:roadmap.adoc[Project Roadmap]
* link:https://openzeppelin-relayer.netlify.app/openzeppelin_relayer/[Technical Rust Documentation^]
* link:https://openzeppelin-relayer.netlify.app/openzeppelin_relayer/[Technical Rust Documentation]
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Don't we want to open on a new tab?

Copy link
Collaborator

Choose a reason for hiding this comment

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

Opening in a new tab sounds good.

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

Successfully merging this pull request may close these issues.

5 participants