prisma-labs / graphql-framework-experiment

Code-First Type-Safe GraphQL Framework
https://nexusjs.org
MIT License
675 stars 66 forks source link

Nexus Migration Guide introduction update #1134

Open mhwelander opened 4 years ago

mhwelander commented 4 years ago

Only applies to nexus <= 0.12 - not to current Nexus Schema Users. (Or actually both: If the go to @nexus/schema it only applies to users of the old Nexus, but going from Schema to Framework everyone can do probably - consider making that a separate guide)

jasonkuhrt commented 4 years ago

I see these paths that should be addressed:

Nexus <= 12 (schema) to @nexus/schema
Nexus <= 12 (schema) to nexus
@nexus/schema to nexus

Of these the third will live longest. It is also ~90% of the content. The first doesn’t even involve the framework and entails almost nothing. The second is a slight variation of the third.

Is your idea that they should be each their own sidenav section? I’m not sure about that. I think the sidenav is more coarse grained than that. For example a migration guide for yoga users will probably happen soon.

My, now that I think about it though, the first path probably doesn’t even belong in that section. It should be located with the standalone component.

What do you think about that?

To help users we could still have the framework guide link to that schema-to-schema path in case that’s what they want.