docs: document SSH support and caveats

yes, start implementing, make a new branch, make meaningful commits, and add tests as you go, when it makes sense create tests first