socket: improve documentation
event_source: add documentation