aboviq/emigrate
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

docs: add a basic FAQ section

Browse source
This commit is contained in:
Joakim Carlstein 2023-12-18 12:10:35 +01:00 • committed by Joakim Carlstein
parent 2a82897ba8
commit 1fc24269f4
2 changed files with 23 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

19
docs/src/content/docs/intro/faq.mdx Normal file
View file

@ -0,0 +1,19 @@
---
title: "FAQ"
description: "Frequently asked questions about Emigrate."
---
## Why no `down` migrations?
> Always forward never backwards.
Many other migration tools support `down` migrations, but in all the years we have been
doing migrations we have never needed to rollback a migration in production,
in that case we would just write a new migration to fix the problem.
In our experience the only time `down` migrations are useful is in development,
and in such case you just revert the migration manually and fix the `up` migration.
The benefit of this is that you don't have to worry about writing `down` migrations, and you can focus on writing the `up` migrations.
This way you will only ever have to write `down` migrations when they are really necessary instead of for every migration
(which makes it the exception rather than the rule, which is closer to the truth).