···15001500Newer migration guides are listed first, and older guides
15011501are further down the page.
1502150215031503+## Upgrading to v1.14.0-alpha
15041504+15051505+Starting with v1.14.0-alpha, the fully knot uses the repoDID as its
15061506+canonical handle for repositories. This unlocks repository
15071507+renames from the appview UI and changes the wire format for
15081508+the following lexicons (`sh.tangled.repo.pull`, `sh.tangled.repo.collaborator`,
15091509+`sh.tangled.repo.issue`, `sh.tangled.git.refUpdate`).
15101510+15111511+Knots that have not been upgraded may silently drop new push
15121512+events, pull requests, issues, and collaborator invites for
15131513+repositories they host until upgraded. So upgrade please!!!
15141514+15151515+- Upgrade to the latest tag (v1.14.0 or above)
15161516+- Head to the [knot dashboard](https://tangled.org/settings/knots) and
15171517+ hit the "retry" button to verify your knot
15181518+15031519## Upgrading to v1.13.0-alpha
1504152015051521Starting with v1.13.0-alpha, every repository on a knot is