update docs with a note on websockets