1999 restart docs

Fix issue #1999 by documenting what `restart` actually does.
Add note re possible breaking changes in future major versions.
Fix `start` doc which refers to tests instead of starting servers.