26 May 2014
Follow @ortaIn March 2013 I uploaded the initial commit for CocoaDocs. This action triggered a roller-coaster year for me. I'm super excited to announce the second iteration of CocoaDocs is now running and parsing new Docsets.
Key Features List
- Travis CI is now important
- Documentation number of shame
- Easy access to License info
- Per library style settings
- Programming Guides
- Dash specific layouts
So it came to me as a surprise that CocoaDocs narrowly beats the CocoaPods Guides in terms of web traffic. It was the original point at which I (orta) had made a major contribution to the OSS community, and whilst it's great technically, it has always bothered me that I was constrained in the design. It bothered me enough that I started a redesign process for the entire of CocoaPods. Now I am free of this burden.
With the mostly solid foundations of CocoaDocs working, I was free to sit back and debate the wider reaching implications. CocoaDocs at its core is about best practices, adding documentation is an important part of a libraries lifecycle. I believe testing is another, because of how easy it is to get started with Travis CI and the fact that it is free for open source it is in my opinion a no-brainer to include that metadata in a library.
Getting started
I also felt that CocoaDocs was a black box for developers who didn't want to read the source code, which is basically everyone. So I've taken the liberty of creating a CocoaDocs Developer Docs. This is an area where you can preview your custom styling, and get the answers to a lot of the questions I've answer on twitter.
Coming up
This is not a full release of CocoaDocs 2, I'm waiting till post-WWDC 2014 to know whether the world has changed yet again to start the process of running CocoaDocs on over 15k libraries. During this time period new libraries get the new style, old libraries keep the old style. There are still a few open issues on CocoaDocs but there's time, we're at a solid 95% now.
CocoaDocs could not have existed without help from appledoc, Danger, the CocoaPods Dev Team and everyone who has contributed a library.