I've made a pull request that adds a section on rebasing with hg bookmarks: https://github.com/thundernest/developer-docs/pull/45 (In case anyone wants to take a look before it lands in the docs proper.) Still on the todo list are documenting the `hg evolve` extension and what to do with old bookmarks once the code has landed. -Paul