adding documentation, changing pairing flow and cleaning up