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

If a type has conformances defined both in the main type declaration and in extensions, `swift-doc` only shows the ones defined directly in type in the docs declaration. For example,...

question
design

In my project, I use a an `enum` as namespacing and nest all my types inside it. The main page looks like this: https://sindresorhus.com/playground/ However, I would like to make...

question

For https://github.com/sindresorhus/KeyboardShortcuts/blob/49b017b2450ac37353934d94d6c64957b62c45b4/Sources/KeyboardShortcuts/Key.swift#L8-L34, I get the following: https://sindresorhus.com/playground/KeyboardShortcuts_Key/ With Jazzy, I get the enum cases grouped too: https://sindresorhus.com/KeyboardShortcuts/Classes/KeyboardShortcuts/Key.html#/Letters

enhancement
design

As an author of the frameworks which work on multiple platforms and have slightly different APIs for each one, I would like to be able to generate different sets of...

enhancement
help wanted

As we begin to add (#65) and consider (#57, #72) new options for the `generate` command, I think it's likely that the number of options for the `generate` command will...

enhancement

Expanding on what's currently in the README, we should provide a step-by-step tutorial to help onboard new users.

documentation
enhancement

The [Service Worker API](https://developer.mozilla.org/en/docs/Web/API/Service_Worker_API) allows webpages to download, install, and activate resources that can later be used by the browser. This allows users to view webpages when they're not connected...

enhancement

> Here be dragons 🐲 In an effort to get everything out the door, I kind of took a "whatever works" approach to development. To that end, [HyperTextLiteral](https://github.com/NSHipster/HypertextLiteral) was great...

enhancement

In the original README, there was a [Motivation section](https://github.com/SwiftDocOrg/swift-doc/tree/b5274fbe4813dc6e6616007009747979315e2cfc#motivation) that included a list of the project's dependencies, like [SwiftSemantics](https://github.com/SwiftDocOrg/SwiftSemantics). We should bring back and revise this for the next release.

documentation

As mentioned in #39, the README used to have a ["Motivation" section](https://github.com/SwiftDocOrg/swift-doc/tree/b5274fbe4813dc6e6616007009747979315e2cfc#motivation) that discussed how `swift-doc` compared to Jazzy. I removed that for the first beta, because a lot of...

documentation