add some docs about the signal types