lib: improve documentation, add Transport section