From 4d64ce00d080771fc176171c9dd11a66451c4cf5 Mon Sep 17 00:00:00 2001 From: Eugene Triguba Date: Sat, 11 Oct 2025 00:02:11 -0400 Subject: Adjust formatting of a few bullets in explanation.md --- docs/explanation.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/explanation.md b/docs/explanation.md index 469a5e6..b3b63a3 100644 --- a/docs/explanation.md +++ b/docs/explanation.md @@ -136,12 +136,14 @@ The version represents the timestamp when the migration was created: - `38` - Second **Trade-offs:** + - **Pros:** - - Avoids filename conflicts when multiple developers create migrations on different branches - - Embeds creation time in the version number + - Avoids filename conflicts when multiple developers create migrations on different branches + - Embeds creation time in the version number + - **Cons:** - - Migration order may not match merge order (e.g., if a migration with an earlier timestamp is merged after one with a later timestamp, it will run out of chronological order) - - Longer, harder to remember version numbers + - Migration order may not match merge order (e.g., if a migration with an earlier timestamp is merged after one with a later timestamp, it will run out of chronological order) + - Longer, harder to remember version numbers **Best for:** Teams working on multiple branches simultaneously where avoiding Git merge conflicts is prioritized over strict chronological ordering. -- cgit v1.2.3