swift-doc icon indicating copy to clipboard operation
swift-doc copied to clipboard

A documentation generator for Swift projects

Results 69 swift-doc issues
Sort by recently updated
recently updated
newest added

This is to partially support #105 and the `@available` attributes. ### AvailabilityAttribute I've added a property to `Symbol` called `availabilityAttributes` to support any attributes that are on the Symbol. `SwiftSemantics`...

Swift-doc really doesn't do a good job of using all of the available space. ![image](https://user-images.githubusercontent.com/5254025/115602074-d1ba0280-a2de-11eb-8e76-64f876ead2f6.png) As a result, it tends to be very uncomfortable to read (at least for me)....

design

Currently, long type names can overflow boxes in hierarchy diagrams.

enhancement
design

Given the following types: ```swift enum Namespace { struct A { /// - Returns: A `B`. func b() -> B { B() } } struct B { /// - Returns:...

enhancement

A project I'm working on makes use of `@_specialize` as an alternative to inlining in certain circumstances. It can be a really great tool for getting the best performance with...

enhancement

Related to #235, it would be nice if nested types would be linked to: ```swift enum Namespace { struct A {} } /// - Returns a `Namespace.A`. func example() ->...

enhancement

Related subtasks: - [ ] Create a `v1` branch Document how to use a tagged release for consistent builds - [ ] Create a workflow that triggers on tags to...

chore

The docs site should show the current version (Git tag) of the project. Before: After:

enhancement
design

It would be nice if each type had a "View Source" link (could be on hover or in a `…` menu) that linked to its source (with the correct SHA...

enhancement
design

I would like to have a link back to the GitHub repo from the docs. Jazzy automatically shows a link in the top-right corner of the docs site if you...

enhancement
design