Skip to content

new Astro Courses / learn Astro page #11895

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

Merged
merged 11 commits into from
Jun 24, 2025
Merged

new Astro Courses / learn Astro page #11895

merged 11 commits into from
Jun 24, 2025

Conversation

sarah11918
Copy link
Member

@sarah11918 sarah11918 commented Jun 18, 2025

Description (required)

Adds a new astro-courses page:

  • as a permanent page for our education partner affiliate links (no matter what we're promoting in the sidebar).
  • potentially gives us SEO for "Astro courses" web searches
  • highlights the (only?) two up-to-date Astro courses in English to provide helpful learning resources and to promote onboarding of new users

Also includes links to community resources Astro Tips and Support Squid, so that these are referenced as alternative sources of knowledge/educational content beyond docs proper and Discord.

Alternatives

We could consider a "tutorial landing page" (as I originally envisioned):

  • unified landing page for affiliate links and our own tutorial
  • this would bump our tutorial from the sidebar
    • what would be highlighted while people are in those pages?
    • would the tutorial feel too "hidden"?
    • if the external courses aren't technically "tutorials", then can one page house them all?
    • would it feel weird to have a "Learn Astro" page in the docs when the docs themselves are for... learning Astro?
  • would community resources feel even more out of place there?
Considerations
  • currently no paragraph text, minimal content beyond ads and link cards: we could keep this minimal focus, to promote clicking and let each course "sell" itself, or add strategic SEO content here.
  • Astro tips has a significant amount of content and is added to at least monthly from our blog post how-to articles! However, Support Squid is very empty (though, we do often reference its "Help me choose a CMS" guide). While its not yet a great resource, something outside of Discord is a noble cause and maybe this will help it.
  • Also noting re: the community resources: neither of these things are "courses" as the page is titled. (Open to renaming the page, the sidebar content, the community section heading if this feels wrong.)
  • No other recommended courses? Most other existing Astro courses are not up to date for Astro 5. (Although Manz.dev did recently release a free Astro course in Spanish: https://lenguajejs.com/astro/ )
  • Eventually, the hope is that there will be more individual Astro courses on Scrimba. If and when that happens, we may want to change our strategy of only linking to the most basic intro course.
  • i18n: we don't currently translate the text in our banner ads. Would we here for the education partners? (Or no, since the courses themselves are in English anyway, so it makes sense to promote them in English?)

Copy link

netlify bot commented Jun 18, 2025

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 7ca9083
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/685adf7eb06e860008d0a567
😎 Deploy Preview https://deploy-preview-11895--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 project configuration.

@astrobot-houston
Copy link
Contributor

astrobot-houston commented Jun 18, 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/astro-courses.mdx Localization added, will be marked as complete.
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.

@sarah11918 sarah11918 added add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. community resource Adds a link to an external community resource, such as a recipe, tutorial or talk. labels Jun 18, 2025
@sarah11918 sarah11918 changed the title initial draft new tutorial landing page new Astro Courses / learn Astro page Jun 21, 2025
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.

Good work! A couple of suggestions from me.

Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
@sarah11918 sarah11918 merged commit c379249 into main Jun 24, 2025
10 checks passed
@sarah11918 sarah11918 deleted the tutorial-landing branch June 24, 2025 17:39
ArmandPhilippot added a commit to ArmandPhilippot/astro-docs that referenced this pull request Jun 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
add new content Document something that is not in docs. May require testing, confirmation, or affect other pages. community resource Adds a link to an external community resource, such as a recipe, tutorial or talk.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants