Looking for the best way to document groovy methods with a map as parameter.

documentation of groovy method with map a property

/**
     * Method with a Map as parameter
     *
     * @param properties Map for the parameters of the method. Supported key: <br/>
     * - param1: String, mandatory<br/>
     * - param2: boolean. Optional(default= true)<br/>
     * - param3: String (any value), Optional(default="Def param3")<br/>
     * @return
     */
    def maMethod(Map properties) {
        ...
    }