---
# System prepended metadata

title: Documentation workgroup 2024 updates

---

# Documentation workgroup 2024 updates

The documentation workgroup continues driving efforts toward a better documentation experience in the Swift ecosystem in the following major areas:

- Ergonomics for linking between documentation. We've made progress towards supporting [a human-readable alternative for symbol link disambiguation][disambiguation] which leverages functions signature information. The 6.0 release supports writing [documentation links to headings and task groups][headings] and includes refinements that make it more natural to document mixed Swift and Objective-C projects using either language representation's spelling of symbols in links.

[disambiguation]: https://forums.swift.org/t/human-readable-alternative-for-docc-symbol-link-disambiguation/65792
[headings]: https://www.swift.org/documentation/docc/linking-to-symbols-and-other-content#Navigate-to-a-Heading-or-Task-Group

- Linking between different targets and documenting multiple targets together. We've made significant progress toward [writing links to other targets and creating combined documentation for multiple targets][multi-target]. The 6.0 release include experimental support for linking between targets behind a feature flag and an experimental command to create combined documentation archives. Links to other targets support all the same features as links to local pages and produce the same rich diagnostics when a link is ambiguous or otherwise unresolvable.

[multi-target]: https://forums.swift.org/t/combined-documentation-of-multiple-targets/59579

- Improved support for documenting overloaded symbols. After [proposing a feature in the forums](https://forums.swift.org/t/improving-the-presentation-of-overloaded-symbols-in-swift-docc/67713) to combine symbol pages for overloaded methods, the 6.0 and trunk toolchains now include this behavior behind a feature flag. Grouped overloads appear once in curation and the navigator, and can be linked to in a symbol link without a disambiguation hash.

- Improved documentation experience on [Swift Package Index](https://swiftpackageindex.com). We ran a number of tests with preview toolchains to determine the impact of upcoming DocC features on packages that host their documentation on the site. Also, changes in DocC reduced the number of files and total documentation size of documentation archives significantly. The Swift Package Index now hosts documentation for more than 700 packages.

- Added the new [`docc init`](https://forums.swift.org/t/pitch-docc-init-command-catalog-templates/67648) command which makes it easy to get started with writing standalone conceptual documentation not attached to a module.

- Continued updating the Swift language documentation for Swift 6 features and new proposals.

Over the next year, the workgroup is interested in developing the following areas:
  
- Support documenting multiple targets, packages, and multi-package projects as a whole with links between targets.

- Improve the readability and expressiveness of links to other symbol documentation pages and articles, for example by extending links' [disambiguation syntax](https://forums.swift.org/t/unified-documentation-links/68128).

- Explore linking between separately hosted documentation—for example, linking to external package dependencies or SDK dependencies.

- Work towards high-level API documentation guidelines to complement the existing API design guidelines.

- Discuss new exploratory documentation systems led by the community, such as [Swiftinit](https://swiftinit.org/help/self-serve).