Skip to content

Comments

Add a documentation catalog.#860

Merged
twostraws merged 4 commits intotwostraws:mainfrom
brokaw:docs
Jan 27, 2026
Merged

Add a documentation catalog.#860
twostraws merged 4 commits intotwostraws:mainfrom
brokaw:docs

Conversation

@brokaw
Copy link
Contributor

@brokaw brokaw commented Jan 27, 2026

Add a .docc catalog to curate the symbols for documentation

If you build the documentation for the current package, it lists all the project symbols in a single collection, and groups them by struct, protocol, enum and so on. It's overwhelming if you're trying to navigate the project for the first time.

This PR adds a documentation catalog and organizes the symbols to match the hierarchy in the Sources folder. There are no changes to the source files, and very little additional documentation added. (I added a project description just so it wasn't blank)..

You can preview these changes either with Xcode's Build Documentation command, or adding the docc package plugin to the manifest.

@twostraws
Copy link
Owner

This is an interesting idea – thank you!

@twostraws twostraws merged commit 58b5e1c into twostraws:main Jan 27, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants