Generate Documentation for Multiple Targets

[JosephDuffy]

Feature Request: Generate Documentation for Multiple Targets

Description:

Generating documentation for multiple targets is not possible, requiring an archive for each target to be generated when a single archive would suffice for some (most?) projects.

Motivation:

Some packages have multiple targets that are intended to be used by consumers. Generating and hosting documentation for each target is time consuming and requires either hosting multiple websites or manually merging documentation.

Personally I would like to host a static site that includes all targets. This discussion was started at swiftlang/swift-docc-plugin#12, where swiftlang/swift-docc-plugin#12 (comment) asked me to create an issue here.

Importance:

Very important for hosting documentation via a static host, e.g. GitHub Pages without manually (and possibly incorrectly) merging the documentation for each target.

Alternatives Considered

Manually merging documentation for multiple targets.

[JosephDuffy]

Just realised this was already requested 🤦

Closing as dupe of #255