e.g. checkout for multiple things, or should it be separated to multiple (switch, restore, checkout).

I felt they were pretty clear here. checkout is overloaded. switch and restore are the new, simpler ways. I switched (ha) myself and it was painless.

I also get the reluctance to deprecate or delete checkout because the whole world uses it