When should I (as a Gradle plugin developer) use a secondary outgoing variant vs creating another primary outgoing variant?

A secondary variant is something that is not published, but only available to other projects in the same build. For example

apiElements

has a secondary variant

classes

, so that other projects in the same build can directly compile against the classes without needing to build the

jar

first.