{"action":"created","issue":{"url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/404","labels_url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/404/labels{/name}","comments_url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/404/comments","events_url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/404/events","html_url":"https://github.com/CocoaPods/cocoadocs.org/issues/404","id":114891607,"number":404,"title":"Docs for mixed Objective-C/Swift library","user":{"login":"NachoSoto","id":685609,"avatar_url":"https://avatars.githubusercontent.com/u/685609?v=3","gravatar_id":"","url":"https://api.github.com/users/NachoSoto","html_url":"https://github.com/NachoSoto","followers_url":"https://api.github.com/users/NachoSoto/followers","following_url":"https://api.github.com/users/NachoSoto/following{/other_user}","gists_url":"https://api.github.com/users/NachoSoto/gists{/gist_id}","starred_url":"https://api.github.com/users/NachoSoto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/NachoSoto/subscriptions","organizations_url":"https://api.github.com/users/NachoSoto/orgs","repos_url":"https://api.github.com/users/NachoSoto/repos","events_url":"https://api.github.com/users/NachoSoto/events{/privacy}","received_events_url":"https://api.github.com/users/NachoSoto/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-11-03T19:30:39Z","updated_at":"2015-11-03T20:55:36Z","closed_at":null,"body":"*I couldn't see any issues regarding this, but apologies if it's a dupe.*\r\n\r\nAs I understand it, `Cocoadocs` will decide to use either `Jazzy` or `Appledoc` depending on the language of the library.\r\nFor [`ReactiveCocoa`](https://github.com/ReactiveCocoa/ReactiveCocoa) this is unfortunate, because it contains more `Objective-C` code than `Swift`, so the docs don't pick up any of the new `Swift` types in `RAC 3/4`.\r\n\r\nWhat does everyone think about this issue? I think there are a few possible options (assuming I'm understanding this problem right):\r\n\r\n- **Support both languages:** probably the highest cost, but ideal solution.\r\n- **Allow libraries to specify the language**: that way libraries like `RAC` could favor `Swift` docs over `Objective-C`, given that it's the new implementation. Not ideal, but possibly the simplest to implement.\r\n- **Somehow generate 2 different sets of documentation, one per language**: not sure if it's possible in practice, but I can see this being another low-cost solution.\r\n\r\nThanks :star:!\r\n\r\nI mean, :heart:!"},"comment":{"url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/comments/153485464","html_url":"https://github.com/CocoaPods/cocoadocs.org/issues/404#issuecomment-153485464","issue_url":"https://api.github.com/repos/CocoaPods/cocoadocs.org/issues/404","id":153485464,"user":{"login":"orta","id":49038,"avatar_url":"https://avatars.githubusercontent.com/u/49038?v=3","gravatar_id":"","url":"https://api.github.com/users/orta","html_url":"https://github.com/orta","followers_url":"https://api.github.com/users/orta/followers","following_url":"https://api.github.com/users/orta/following{/other_user}","gists_url":"https://api.github.com/users/orta/gists{/gist_id}","starred_url":"https://api.github.com/users/orta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/orta/subscriptions","organizations_url":"https://api.github.com/users/orta/orgs","repos_url":"https://api.github.com/users/orta/repos","events_url":"https://api.github.com/users/orta/events{/privacy}","received_events_url":"https://api.github.com/users/orta/received_events","type":"User","site_admin":false},"created_at":"2015-11-03T20:55:36Z","updated_at":"2015-11-03T20:55:36Z","body":"> I mean, :heart:!\r\n\r\nhah.\r\n\r\nSo it's likely that https://github.com/jpsim/SourceKitten/pull/57 is going to probably be the answer for this, meaning a move to supporting only Jazzy. Though, how well that works on plain of static libraries is something I don't know yet.  \r\n\r\nI don't think 2 sets of docs is feasible, at least not in a reasonable way. But allowing the library to select the language is an interesting choice, we already have [config files](http://cocoadocs.org/readme/) so libraries can use their own colour schemes or custom `pod try` pre-install hooks. So it's definitely an option if it looks like Objective-C Jazzy is way off."}}