`transports.c` has a big documentation blob documenting how the transports subsystem works. Unfortunately, this is not currently visible by doxygen. We should put it in the file-level Doxygen header so that it shows nicely in Doxygen documentation.