Skip to content

docs: Docusaurus v3.0 blog post#9433

Merged
slorber merged 44 commits intomainfrom
slorber/v3-blog-post
Oct 31, 2023
Merged

docs: Docusaurus v3.0 blog post#9433
slorber merged 44 commits intomainfrom
slorber/v3-blog-post

Conversation

@slorber
Copy link
Collaborator

@slorber slorber commented Oct 20, 2023

@slorber slorber added the pr: documentation This PR works on the website or other text documents in the repo. label Oct 20, 2023
@slorber slorber added this to the 3.0 milestone Oct 20, 2023
@facebook-github-bot facebook-github-bot added the CLA Signed Signed Facebook CLA label Oct 20, 2023
@netlify
Copy link

netlify bot commented Oct 20, 2023

[V2]

Name Link
🔨 Latest commit a8c7490
🔍 Latest deploy log https://app.netlify.com/sites/docusaurus-2/deploys/6541233d5ed1ac0007f52abb
😎 Deploy Preview https://deploy-preview-9433--docusaurus-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@github-actions
Copy link

github-actions bot commented Oct 20, 2023

Size Change: -127 B (0%)

Total Size: 1.13 MB

Filename Size Change
website/build/assets/js/main.********.js 865 kB +2.87 kB (0%)
website/build/index.html 38.4 kB -2.99 kB (-7%)
ℹ️ View Unchanged
Filename Size Change
website/.docusaurus/globalData.json 117 kB 0 B
website/build/assets/css/styles.********.css 113 kB -15 B (0%)

compressed-size-action

@github-actions
Copy link

github-actions bot commented Oct 23, 2023

⚡️ Lighthouse report for the deploy preview of this PR

URL Performance Accessibility Best Practices SEO PWA Report
/ 🟠 73 🟢 97 🟢 100 🟢 100 🟠 89 Report
/docs/installation 🟠 80 🟢 98 🟢 100 🟢 100 🟠 89 Report
/docs/category/getting-started 🟠 74 🟢 100 🟢 100 🟢 90 🟠 89 Report
/blog 🟠 63 🟢 100 🟢 100 🟢 90 🟠 89 Report
/blog/preparing-your-site-for-docusaurus-v3 🟠 79 🟢 97 🟢 100 🟢 100 🟠 89 Report
/blog/tags/release 🟢 91 🟢 100 🟢 100 🟠 80 🟠 89 Report
/blog/tags 🟢 94 🟢 100 🟢 100 🟢 90 🟠 89 Report

@slorber slorber marked this pull request as ready for review October 23, 2023 16:40
Copy link
Collaborator

@Josh-Cena Josh-Cena left a comment

Choose a reason for hiding this comment

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

Looks mostly great! I am already getting excited.

@Josh-Cena
Copy link
Collaborator

Have we mentioned the maintenance state of v2 onwards anywhere? I think for every new major release, we should restate the note on https://docusaurus.io/community/release-process#versions, because it helps with discoverability. We can add this to the intro section:

This also means v2 has now entered maintenance mode. It will continue to receive support only for major security issues for 3 months (ending in late January, 2024). Otherwise, all features will be frozen and non-critical bugs will not be fixed.

It is recommended to upgrade within that time frame to v3.

slorber and others added 9 commits October 24, 2023 16:41
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
@slorber
Copy link
Collaborator Author

slorber commented Oct 24, 2023

Thanks for the reviewx @Josh-Cena 👍

Have we mentioned the maintenance state of v2 onwards anywhere? I think for every new major release, we should restate the note on docusaurus.io/community/release-process#versions, because it helps with discoverability. We can add this to the intro section:

Added this to the blog post with a clear end of support date 👍

CleanShot 2023-10-24 at 17 48 10@2x

Also moved the truncate marker a bit because the summary was a bit too long IMHO

CleanShot 2023-10-24 at 17 49 02@2x

Copy link
Collaborator

@Josh-Cena Josh-Cena left a comment

Choose a reason for hiding this comment

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

Incomplete reviews

@Josh-Cena
Copy link
Collaborator

@dmitryvinn To make editorial suggestions, please use the suggestion button, especially because otherwise it's hard to see how the Markdown works.

@slorber slorber merged commit a456fef into main Oct 31, 2023
@slorber slorber deleted the slorber/v3-blog-post branch October 31, 2023 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed Signed Facebook CLA pr: documentation This PR works on the website or other text documents in the repo.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants