JSDoc/Docstrap generation

- Made deprecated entries more apparent
  - A deprecation notice is moved above the description to make
    it actually obvious
  - The navigation item is marked (currently with line-through)
    to visual discourage even thinking about it.

- "protected" members are displayed as "internal"
  - Enforces the idea that using them from outside the core library
    is possible even though there is no public guarantee
  - There is also and advice note added to the "Deprecated/Internal"
    section reminding the users of such.

- The "Type" heading is removed when such is trivially visible in the
  type-signature of the item.

- The "Returns" section for methods is moved before the details
  (So it is displayed about the "Source" and other details.)

- The type is better integrated into "Returns"
JSDoc/Docstrap generation - cleanup

- Reverted unecessary change
JSDoc/Docstrap generation

- "Source" section doesn't invoke a bullet, "src/" leading path removed
- Minor styles
Merge pull request #1308 from pnstickne/wip-jsdoc-format

JSDoc template updates - cleanup and some changes