Deprecate git-checkout

One topic at panel discussion at the Git Mini Summit was how confusing git-checkout(1) is. With git-switch(1) and git-restore(1) now no longer being experimental, we should guide all users toward those commands and remove all mentions of git-checkout(1), and eventually mark it as deprecated.

This is mostly documentation work.