signals: Add detail section; do proper unambiguous referencing; use the first sentence as a short description.