Golang Go Doc Comment: Support @ tags

Proposal Details

Please add support for @ tags in Go Doc Comments. This can be used to add specific documentation on specific parts of the syntax such as function parameters, function return values, and more

Here is how the Go Doc Comment syntax can look with these tags

// Function description...
//
// @param 1st function parameter description...
// @param 2nd function parameter description...
// @return 1st function return value description...
// @return 2nd function return value description...
func myFunction(a bool, b int) (bool, int) {
    //...
}

These tags can be parsed in IDEs to when one hovers their cursor over the function to show the description of each parameter and return value and be parsed for documentation of packages published on pkg.go.dev

These @ tags are common in other documentation comments from other languages such as JavaScript, PHP, Python and others.

https://jsdoc.app/

An alternative would be to support the DocBlock comment standard which would look like this...

/**
 * Function description...
 * @param 1st function parameter description...
 * @param 2nd function parameter description...
 * @return 1st function return value description...
 * @return 2nd function return value description...
 */
func myFunction(a bool, b int) (bool, int) {
    //...
}

However I do not see this being needed adding DocBlock into Go, by simply adding @ tags in the Go Doc Comments would provide most if not all of the missing features from DocBlock.