prisma / prisma-content-feedback

Feedback for documentation, articles, tutorials, examples, ...
https://www.prisma.io/docs/
6 stars 2 forks source link

Broken links in Get Started Guide + suggestion for change #103

Open bchehraz opened 5 years ago

bchehraz commented 5 years ago

Article Title:

Under the section "Get Started"

Change Datamodel

Issue:

At the top of this article is a warning that states the following, including the broken links:

This page is only relevant if you started with a new database or a Demo server. If you configured Prisma with an existing database, you need to run migrations directly against your database.

I think it's a bit confusing to have these linked. Not just that they don't work but it doesn't make sense to link those pages. Really the migrations page should be linked e.g. for MySQL https://www.prisma.io/docs/datamodel-and-migrations/migrations-MYSQL-asdf/.

Also, the migrations article link from inside the documentation automatically takes you to the page for MySQL and it is hard to tell that there are other articles for migrations on PostgreSQL and MongoDB. Especially on smaller screen sizes where those options may be hidden (they are for me when I lower the screen size). For this reason, I think all 3 migration pages should be linked here.

Describe the solution you'd like to see

Change the warning text to the following, or something similar:

This page is only relevant if you started with a new database or a Demo server. If you configured Prisma with an existing database, you need to run migrations directly against your database. (See Migrations for MySQL, PostgreSQL, or MongoDB).

This way, there's a much clearer understanding that the warning has to do with migrations.