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 Gatsby migration doc to reflect new content behavior #10189

Closed
JusticeMatthew opened this issue Dec 4, 2024 · 2 comments · Fixed by #10597
Closed

Update Gatsby migration doc to reflect new content behavior #10189

JusticeMatthew opened this issue Dec 4, 2024 · 2 comments · Fixed by #10597
Labels
help wanted Issues looking for someone to run with them! improve or update documentation Enhance / update existing documentation (e.g. add example, improve description, update for changes)

Comments

@JusticeMatthew
Copy link
Contributor

📚 Subject area/topic

guide

📋 Page(s) affected (or suggested, for new content)

https://docs.astro.build/en/guides/migrate-to-astro/from-gatsby/#migrating-pages-and-posts

📋 Description of content that is out-of-date or incorrect

As mentioned by @bholmesdev in discord, the linked Gatsby migration documentation still states that in Astro all content must be in the src directory

This is no longer the case thanks to the content layer

🖥️ Reproduction in StackBlitz (if reporting incorrect content or code samples)

No response

@JusticeMatthew JusticeMatthew added the improve or update documentation Enhance / update existing documentation (e.g. add example, improve description, update for changes) label Dec 4, 2024
@sarah11918 sarah11918 added the help wanted Issues looking for someone to run with them! label Dec 4, 2024
@sarah11918
Copy link
Member

Indeed! I think many of our "migrate to" probably follow this wording. (Whatever Gatsby says, probably Next and Nuxt say something similar as those are our three "most full" guides).

Would happily accept a PR for someone scanning through for outdated language regarding content collections restrictions and updating for the new reality in v5! 🚀

@sarah11918
Copy link
Member

the three guides migrating from Gatsby, Next, and Nuxt all probably have this identical section:

Migrating Pages and Posts
In Gatsby, your pages and posts may exist in src/pages/ or outside of src in another folder, like content. In Astro, all your page content must live within src/.

Let's change this to:
Migrating Pages and Posts
In Gatsby, your pages and posts may exist in src/pages/ or outside of src in another folder, like /content/. With content collections, your source content can also exist outside of your Astro project entirely.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Issues looking for someone to run with them! improve or update documentation Enhance / update existing documentation (e.g. add example, improve description, update for changes)
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants