Skip to content

Migration AWAY from Migration Guide? #519

Description

@sarah11918

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!

Metadata

Metadata

Assignees

No one assigned

    Labels

    improve or update documentationEnhance / update existing documentation (e.g. add example, improve description, update for changes)should this be documented?Need to figure out whether this is something to add to documentation or notsite improvementSome thing that improves the website functionality - ask @delucis for help!

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions