Overload pages shows the description and documentation for the first overload

[anarthal]

https://www.boost.org/doc/libs/master/doc/antora/url/reference/boost/urls/url/2constructor.html

I think this is confusing.

[alandefreitas]

We got that pattern from Boost.JSON, where the documentation comes from the first member. It works most of the time for member functions. But it's terrible for things like operator<<.

We can start by removing the description and only showing a union of the parameters, which is less controversial. Later, we could reintroduce a better way to inherit details about the overload set from the functions.

A number of heuristics could be used here:

• Don't inherit details from free functions
• Inherit details when only one overload is documented
• ...