docs(*): ensure jsdoc type expressions are valid

These changes are to coincide with the forthcoming change to dgeni-packages: https://github.com/angular/dgeni-packages/pull/10

There are a bunch of invalid jsdoc type expressions that will break if you use the new dgeni tagParser.  This PR will fix those.  Unfortunately, the docs will look wrong if we merge them before the new tagParser arrives.