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

upgrading Docusaurus to v3 #374

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

upgrading Docusaurus to v3 #374

wants to merge 20 commits into from

Conversation

Aditya-eddy
Copy link
Contributor

@Aditya-eddy Aditya-eddy commented Apr 16, 2024

Pull Request Template

Description

fixes #1833
We should upgrade to v3 so that we increase the browsers support.

Fixes # (issue)

Type of change

Please delete options that are not relevant.

  • Bug fix (non-breaking change which fixes an issue).
  • New feature (non-breaking change which adds functionality).
  • Breaking change (fix or feature that would cause existing functionality to not work as expected).
  • This change requires a documentation update.

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration

Additional Context (Please include any Screenshots/gifs if relevant)

...

Checklist:

  • My code follows the style guidelines of this project.
  • I have performed a self-review of my own code.
  • I have made corresponding changes to the documentation.
  • I have added corresponding tests.
  • Any dependent changes have been merged and published in downstream modules.

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@re-Tick
Copy link

re-Tick commented Apr 16, 2024

Hey @Aditya-eddy ,Please mention the issue number for discussion. @Sonichigo Please review.

@Aditya-eddy
Copy link
Contributor Author

Hey @re-Tick I just created the pr and pushed it. Have not created an issue for it should I?

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@re-Tick
Copy link

re-Tick commented Apr 17, 2024

Hey @re-Tick I just created the pr and pushed it. Have not created an issue for it should I?

It will be good to mention the issue.

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@@ -1,40 +0,0 @@
/**
Copy link
Member

Choose a reason for hiding this comment

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

Hey @Aditya-eddy what's the reason behind removing these files are they not getting used now ?

Copy link
Member

Choose a reason for hiding this comment

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

Also can you please check this warning

(node:187143) [DEP_WEBPACK_COMPILATION_ASSETS] DeprecationWarning: Compilation.assets will be frozen in future, all modifications are deprecated.
BREAKING CHANGE: No more changes should happen to Compilation.assets after sealing the Compilation.
Do changes to assets earlier, e. g. in Compilation.hooks.processAssets.
Make sure to select an appropriate stage from Compilation.PROCESS_ASSETS_STAGE_*.
(Use node --trace-deprecation ... to show where the warning was created)
client (webpack 5.88.2) compiled successfully

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hey @Hermione2408 about the deleted files I think they were used for blogs section. But I don't think there is any blog section in website. Let me look into the error!

@Sonichigo
Copy link
Member

Sonichigo commented Apr 22, 2024

Hey @Aditya-eddy, there is an error while starting with yarn start && yarn build

image

With last commit as well the deploy check is failing :- https://github.com/keploy/docs/actions/runs/8749516911/job/24011321177?pr=374

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@Aditya-eddy
Copy link
Contributor Author

Hey @Aditya-eddy, there is an error while starting with yarn start && yarn build
With last commit as well the deploy check is failing :- https://github.com/keploy/docs/actions/runs/8749516911/job/24011321177?pr=374

Hey @Sonichigo actually the docusaurus uses nodejs>=18, but in the github workflow file it was downloading the 16 some version. I have corrected the version to 18.0.0 nodejs. I think the workflow went smoothly this time. But please do check and give feedback on it. Thanks!!

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
Copy link
Member

@Sonichigo Sonichigo left a comment

Choose a reason for hiding this comment

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

image

@Aditya-eddy there are certain warning that needs to be fixed before final merge

Sonichigo and others added 2 commits April 25, 2024 11:20
Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@Aditya-eddy
Copy link
Contributor Author

Hey @Sonichigo I have resolved all the errors only the pet-clinic error is remaining because in there we have used h1 anchors manually whiich docusaurus does not allow hence shows. Broken-Links Reference here.
Please give you feedback on this. Thanks!!

Copy link
Member

@Sonichigo Sonichigo left a comment

Choose a reason for hiding this comment

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

In http://localhost:3000/docs/quickstart/pet-clinic/ there are two brokenAnchors warning! You can use below to update and fix those.

# Instructions For Starting Using Binary <a name="binary-guide"></a>

to 

## Instructions For Starting Using Binary.

and

# Instructions For Starting Using Docker <a name="docker-guide"></a>
to
## Instructions For Starting Using Docker

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@Aditya-eddy
Copy link
Contributor Author

Hey @Sonichigo I have pushed the updated changes!

Copy link
Member

@nehagup nehagup left a comment

Choose a reason for hiding this comment

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

@Aditya-eddy this is great! Just that we can't make h1 tags h2. We need to find a workaround to maintain h1 tags.
Instead of using anchors we can directly link endpoints for H1 in case anchors are not supported for H1s.

Signed-off-by: Aditya-eddy <aditya282003@gmail.com>
@Aditya-eddy
Copy link
Contributor Author

Hey @nehagup i have swizzled heading component and made the h1 tags have anchors too. By default they will have id as heading but we can set them explicitly by #heading {#id}. Please give feedback on this.

@Aditya-eddy Aditya-eddy requested a review from nehagup May 3, 2024 03:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
5 participants