Runestone Documentation Issue: Migration troubleshooting in 6.5

[magnus-mccaslin]

Page found:

https://docs.runestone.academy/en/latest/running.html

Description

While working through the installation process, I encountered a migration issue during updating in 6.5 that was resolved by manually stamping the database to the latest Alembic revision. These troubleshooting steps are not currently included in the official documentation, but could help users who continue to experience migration errors after following the standard setup process.

I suggest adding the following note to the installation or troubleshooting section of 6.5:

If you are still experiencing migration errors, try the following commands:

docker compose run --rm rsmanage alembic stamp head
docker compose run --rm rsmanage alembic current

The second command should display the current revision with (head) next to it. If it does, the migration issue has been successfully resolved.

Including these commands would provide users with a straightforward way to recover from migration state mismatches without having to search through issue discussions or ask for support.

GitHub: magnus-mccaslin

[PuskarC]

Jairus, Merci and I are working on this issue