DocC Documentation for targets other than static and dynamic libraries

Question

Created Jan ’22

Replies 2

Boosts 0

Views 1.5k

Participants 2

Is it possible to add DocC documentation to a target that does not result in either a static library or a framework? It doesn't yet appear to be a feature of DocC. If not, will there be support in the future to add documentation to "regular" Xcode projects that don't result in a static library or framework? I think it could be useful to have documentation for larger apps that may use multiple frameworks in complex ways

Answered by DTS Engineer in 701748022

It doesn't yet appear to be a feature of DocC.

Correct.

If not, will there be support in the future to add documentation to "regular" Xcode projects that don't result in a static library or framework?

I can’t predict the future. What I can say is:

This is a much-requested feature.
Normally in such cases I’d suggest that you file an enhancement request for that feature, but in this case I think the team already has a good understanding of its importance.
There’s been discussions about this over on Swift Forums > DocC (sorry I can’t find the link to the specific thread).
DocC is an open source project, and I encourage you to get involved.

Share and Enjoy
—
Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

Boost

Answer 1

DTS Engineer OP

Apple

Jan ’22

Accepted Answer

It doesn't yet appear to be a feature of DocC.

Correct.

If not, will there be support in the future to add documentation to "regular" Xcode projects that don't result in a static library or framework?

I can’t predict the future. What I can say is:

This is a much-requested feature.
Normally in such cases I’d suggest that you file an enhancement request for that feature, but in this case I think the team already has a good understanding of its importance.
There’s been discussions about this over on Swift Forums > DocC (sorry I can’t find the link to the specific thread).
DocC is an open source project, and I encourage you to get involved.

Share and Enjoy
—
Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

2

Answer 2

DTS Engineer OP

Apple

Jan ’22

I can’t predict the future.

Oooh, it seems like the future is now! Xcode 13.3 Beta Release Notes says:

Xcode can now build documentation from your Swift code in executable targets, like apps and command-line tools. (79155998) (FB9156246)

I haven’t had a chance to try it for myself yet but I’m definitely looking forward to that.

Share and Enjoy
—
Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

1