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

Update community resources for migration guides #11376

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

Conversation

sarah11918
Copy link
Member

@sarah11918 sarah11918 commented Apr 5, 2025

Description (required)

Updates the "Migrate to Astro from..." guides in the Community resources section to:

  • all use the Starlight <LinkCard>s (like the Gatsby one currently does) instead of Markdown links
  • add new links from the "What's New?" monthly Astro Blog showcase posts (Oct 2023 to March 2025)
  • adds the same note at the bottom of the Gatsby one encouraging people to add posts they write or find (with the "edit this page" link removed). These are customized with the name of the framework. Please check they are correct.

Also updates a few CMS/deploy guides when similar relevant community resources were found.

DRAFT:

This is a draft because I haven't yet previewed, nor thought about strategic ordering of entries. Just got all content added and committed quickly because I was having editor issues.

TO REVIEW:

Visit every Migration guide and check the bottom of the page (Community Resources section) for anything amiss! Link cards can be reordered if you see a better ordering!

Copy link

netlify bot commented Apr 5, 2025

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 11827f4
🔍 Latest deploy log https://app.netlify.com/sites/astro-docs-2/deploys/67f53d73310bd00008c355b2
😎 Deploy Preview https://deploy-preview-11376--astro-docs-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.

@astrobot-houston
Copy link
Contributor

astrobot-houston commented Apr 5, 2025

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/guides/cms/directus.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/drupal.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/ghost.mdx Source changed, localizations will be marked as outdated.
en/guides/cms/wordpress.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-create-react-app.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-docusaurus.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-eleventy.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gatsby.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gitbook.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gridsome.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-hugo.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-jekyll.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nextjs.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nuxtjs.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-pelican.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-sveltekit.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-vuepress.mdx Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-wordpress.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

Copy link
Member

@ArmandPhilippot ArmandPhilippot left a comment

Choose a reason for hiding this comment

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

This looks great! And I think this wasn't a funny task so... 🙌🏽

I only left a few suggestions: some reorganization based on Firefox adaptive view, and two more generic comments (not necessarily an issue, but just to share in case you have better ideas than me 😄 ).

I'm not sure what we can do regarding the "strategic ordering of entries". I guess we could define the most recent links at the top to make them more visible but:

  • This could conflict with space balancing
  • If someone adds a new link, I guess the most logical position in this case is at the bottom so... this is not better than no ordering I guess.

Copy link
Member Author

@sarah11918 sarah11918 left a comment

Choose a reason for hiding this comment

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

updating "add to the list" CTAs

@sarah11918 sarah11918 marked this pull request as ready for review April 7, 2025 21:53
@sarah11918 sarah11918 added add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. consistency/formatting Standardizing without changing docs content e.g. indenting, lists etc. community resource Adds a link to an external community resource, such as a recipe, tutorial or talk. and removed add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. labels Apr 7, 2025
Copy link
Member

@ArmandPhilippot ArmandPhilippot left a comment

Choose a reason for hiding this comment

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

Good job! 🙌🏽 I only left a suggestion on cms/wordpress to find a better balance.

Co-authored-by: Armand Philippot <[email protected]>
Copy link
Member

@yanthomasdev yanthomasdev left a comment

Choose a reason for hiding this comment

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

LGTM!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community resource Adds a link to an external community resource, such as a recipe, tutorial or talk. consistency/formatting Standardizing without changing docs content e.g. indenting, lists etc.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants