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

Open
JusticeMatthew opened this issue Dec 4, 2024 · 2 comments
Open

Update Gatsby migration doc to reflect new content behavior #10189

JusticeMatthew opened this issue Dec 4, 2024 · 2 comments
Labels
help wanted Issues looking for someone to run with them! improve documentation Enhance existing documentation (e.g. add an example, improve description)

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 documentation Enhance existing documentation (e.g. add an example, improve description) 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 documentation Enhance existing documentation (e.g. add an example, improve description)
Projects
None yet
Development

No branches or pull requests

2 participants