Cannot add JSDOC comments in .sol file in VS Code. Any help?

Question

I have been trying to use JSDOC comments in my smart contract files (as many contracts already have), but my VS Code seems to be not picking up the structure using the usual commant of /** */

Although, the comments are working fine in the test files which are .ts. Any idea how can I do it?

Sample Comments Requirement:

/**
 * @param a
 * @param b
 * @returns
 */

Answer 1

Doc for Solidity is a bit different -

    /**
     * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
     * on the return value: the return value is optional (but if data is returned, it must not be false).
     * @param token The token targeted by the call.
     * @param data The call data (encoded using abi.encode or one of its variants).
     */
     function _callOptionalReturn(IERC20Upgradeable token, bytes memory data) private { ... }

Another example with returns -

    /**
     * @dev Returns the admin role that controls `role`. See {grantRole} and
     * {revokeRole}.
     *
     * To change a role's admin, use {_setRoleAdmin}.
     */
    function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) { ... }