Those documents lived in ref/, but really aren't reference documents.
Topics/ is a more appropriate place for them.

* Use correct directives in signals.rst
* Removed newline in glossary.rst that broke sorting of glossary terms
* Removed syntax warning for upgrading.rst

Fixes #608