How to document overloaded functions?

Should we try using https://www.doxygen.nl/manual/commands.html#cmdoverload instead of copy pasting all the parameter descriptions of the overloaded methods? (see the PID class)

but how?

This works in doxygen

  /*!
   * \brief Get PID gains for the controller.
   * \param p The proportional gain.
   * \param i The integral gain.
   * \param d The derivative gain.
   * \param i_max Upper integral clamp.
   * \param i_min Lower integral clamp.
   * \param antiwindup Antiwindup functionality. When set to true, limits
        the integral error to prevent windup; otherwise, constrains the
        integral contribution to the control output. i_max and
        i_min are applied in both scenarios.
   */
  void get_gains(
    double & p, double & i, double & d, double & i_max, double & i_min, bool & antiwindup);

  /*!
    * \brief Get PID gains for the controller.
    * \overload
    */
  void get_gains(double & p, double & i, double & d, double & i_max, double & i_min);

but is not parsed nicely from vscode.

https://devblogs.microsoft.com/cppblog/improved-doxygen-overload-resolution/ it seems that this feature also does not exist yet in the released version.

Any chance to satisfy both worlds?

Start by inspecting the PID class documentation and its overloaded get_gains declarations. Compare the current Doxygen output with how the declarations are parsed in VS Code, then review the linked Doxygen overload documentation and released-version limitations. Done means a documented approach is identified that preserves readable generated documentation and acceptable editor parsing, or the incompatibility is clearly recorded.