The GitBook migration trap
The obvious way to migrate off GitBook — export every page and import it verbatim — quietly forklifts the drift you were trying to escape, and leaves frozen islands in an otherwise self-updating site. A better migration treats the old docs as a seed, regenerates from the code, and measures topic coverage so you can prove nothing important was lost.