laughinghan/mathquill — comment on commit 6c9bd8942cd9e0ca9301e7f2e1bf164193565c4f
File:  line 0
By laughinghan:

We've never had an occasion to call a method like this. Remember how back when we had these, we only ever called `insertBefore`?

Also, the reason I chose the naming scheme `adopt` and `disown`, distinct from the DOM/jQuery `insert`, `remove` and `detach` naming scheme, was that you don't need to call `detach` before calling `insert`, but you usually have to call `disown` before calling `adopt`. The exception to the latter is `createBefore`, since nodes are born orphans, so to speak, so if `createBefore` called `insertBefore`, it would either be needlessly rearranging former parent and siblings it doesn't know don't exist, or `insertBefore` would be dangerously different from jQuery's `insertBefore`. But `createBefore` calling `adopt` makes sense, since it's born an orphan.