add some docs in the signals module