added documentation for signals