signals docs cleanups