# Any plans for adopting DocC? **URL:** \ **Category:** Alamofire\ **Tags:** documentation, docc\ **Created:** [November 2, 2021, 1:37pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234 "2021-11-02T13:37:00Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![TiagoLopes](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/tiagolopes/32/15279_2.png) [@TiagoLopes](https://forums.swift.org/u/TiagoLopes)\ **Post date:** [November 2, 2021, 1:37pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/1 "2021-11-02T13:37:00Z")
Is this something Alamofire would be interested in having? ---
**Author:** ![Jon\_Shier](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jon_shier/32/921_2.png) [@Jon\_Shier](https://forums.swift.org/u/Jon_Shier)\ **Post date:** [November 2, 2021, 3:27pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/2 "2021-11-02T15:27:45Z")
Yes, and I already have this integrated in a branch (`feature/docc-docs`). However, until DocC can be hosted on GitHub pages or we integrate another hosting solution, there's not much value to having it. I'd also like to see if DocC can remove the Xcode project integration and build from the package or completely dynamically. ---
**Author:** ![Mordil](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/mordil/32/5840_2.png) [@Mordil](https://forums.swift.org/u/Mordil)\ **Post date:** [November 2, 2021, 10:35pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/3 "2021-11-02T22:35:37Z")
> [@Jon\_Shier](#): > > build from the package or completely dynamically. What do you mean by this? There's still benefit for those who use the project through SwiftPM in a Swift Package for offline viewing. When you have a Swift Package opened in Xcode 13, if the Package.swift defines `5.5`, then it will generate DocC output for your package, and any of the dependencies in the graph ![Screen Shot 2021-11-02 at 15.34.50](https://global.discourse-cdn.com/swift/original/3X/3/1/31851df9881256e54f1cd6b09ae9108be40c483d.png) ---
**Author:** ![Jon\_Shier](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jon_shier/32/921_2.png) [@Jon\_Shier](https://forums.swift.org/u/Jon_Shier)\ **Post date:** [November 2, 2021, 10:45pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/4 "2021-11-02T22:45:07Z")
Interesting, but if that's autogenerated, wouldn't that just work with a 5.5 package? Overall I'm not interested in specifically supporting DocC until it can replace our hosted documentation. Maintaining duplicate documentation sets just doesn't make sense. ---
**Author:** ![Mordil](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/mordil/32/5840_2.png) [@Mordil](https://forums.swift.org/u/Mordil)\ **Post date:** [November 2, 2021, 10:48pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/5 "2021-11-02T22:48:33Z")
> [@Jon\_Shier](#): > > Interesting, but if that's autogenerated, wouldn't that just work with a 5.5 package? Sure, it works out of the box - you don't have to do any work. It's just none of the guides, tutorials, etc. power of DocC is utilized in the generated output. I guess the question is "what does DocC support/adoption mean"? ---
**Author:** ![Jon\_Shier](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jon_shier/32/921_2.png) [@Jon\_Shier](https://forums.swift.org/u/Jon_Shier)\ **Post date:** [November 2, 2021, 10:53pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/6 "2021-11-02T22:53:31Z")
"Support" means customizing the DocC integration in Xcode to bring in our guides and properly link to the rest of the DocC content. Then properly hosting it somewhere so our on and offline docs are the same, which just isn't possible (easily) right now. It means replacing our Jazzy docs. ---
**Author:** ![Peter-Schorn](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/peter-schorn/32/11183_2.png) [@Peter-Schorn](https://forums.swift.org/u/Peter-Schorn)\ **Post date:** [November 3, 2021, 1:31am UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/7 "2021-11-03T01:31:35Z")
You should consider using [VaporDoc](https://github.com/josephduffy/VaporDocC/pkgs/container/vapordocc) to create a vapor app that hosts your documentation. Then, you can host it on heroku. You can link to the web page from the README in your repo. Although github pages is certainly more convenient, I don't think DocC's lack of compatibility with it, alone, should hold you back from using it. After all, github pages is merely one of many ways of hosting online documentation. ---
**Author:** ![Jon\_Shier](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jon_shier/32/921_2.png) [@Jon\_Shier](https://forums.swift.org/u/Jon_Shier)\ **Post date:** [November 3, 2021, 1:40am UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/8 "2021-11-03T01:40:28Z")
Given we already have generated documentation, I’m not willing to spend even more effort and long term investment for an alternative with no real advantage (without creating unique docs that only work with DocC). Given the (apparent) ongoing work to make the docs easier to host it seems best to wait and see how that plays out before investing more effort. I will try to get a 5.5 package merged soon so that people can see the autogenerated docs. ---
**Author:** ![Jon\_Shier](https://sea2.discourse-cdn.com/swift/user_avatar/forums.swift.org/jon_shier/32/921_2.png) [@Jon\_Shier](https://forums.swift.org/u/Jon_Shier)\ **Post date:** [November 3, 2021, 7:46pm UTC](https://forums.swift.org/t/any-plans-for-adopting-docc/53234/9 "2021-11-03T19:46:40Z")
Doesn't look like this works with Xcode projects integrating Swift packages unfortunately (though unsurprisingly). I'll still update the package though.