Optimise method and interface descriptions for the `core` package

[Benno]

🆕 Feature Request

Something like that

/**
 *  tagline.
 *
 *  more description.
 *
 *  Learn more: [link to documentation part]
 * 
 * @param {object} x - description.
 * @param {State} y - description.
 * @returns {State} - description.
 *
 */
function myCoolMethod() {
  // xyz
}