Topic named after objects in Usage section rather than specified topic name

[lionel-]

From r-lib/rlang#959.

The topic was defined as @name bang-bang but pkgdown included it in the reference index under the name qq_show. When I removed qq_show() from the Usage section, it got indexed under its intended name.

[maelle]

This comes from the lines

pkgdown/R/build-reference-index.R

Lines 50 to 54 in 88b3b3d

	aliases = purrr::map2(
	topics$funs,
	topics$name,
	~ if (length(.x) > 0) .x else .y
	),

I can't think of a good solution that'd work automatically. Workarounds currently would be to make sure the Rd title contains the important keywords.

[hadley]

I'm not sure if we can fix this (or if it's worth the effort to figure out how to fix it). We already have a fairly sophisticated set of heuristics to figure out what to display because generally the usage gives the user the most informative targets for clicking — it's only in relatively few cases where you actually want to see the topic name or raw aliases.

[hadley]

Maybe if there's no funs we should use all the aliases? I think that will affect little existing documentation, but open the door to creative use.