Migration AWAY from Migration Guide? #586
sarah11918
started this conversation in
Ideas
Replies: 1 comment
-
Relatedly, I noticed our Getting Started page currently links to the migration guide basically before anything else. That seems like something we can stop doing long before we can remove the guide itself. Maybe even already? |
Beta Was this translation helpful? Give feedback.
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
Migration will be less of an issue as we get closer to and past v1, and I think it will be sufficient to refer to "updating!" or "What's new!"
I'd like to put on our radar pruning (eventually removing?) the Migration docs, and/or giving them less prominence going forward. We have some migrations TO things in early versions that we have since yet migrated away FROM. So, this can be a potential source of confusion for people arriving via search results (either external, or within our own Algolia search.)
I also think What's New? is more attention getting, even for people on relatively new versions of Astro, who might be compelled to look there "just to see" vs clicking on a Migration Guide, which sounds more formal and like something you'd read if you had a purpose.
So, just putting this on our radar!
Beta Was this translation helpful? Give feedback.
All reactions