Appledoc became quite popular amongs Cocoa developers, especially since 2.0. It also seen many contributions from various users. But it has become very hard to maintain. In this blog post I’ll describe the reasons and future directions.

Previously, appledoc used it’s home page for general info - a hub to source files and documentation which was hosted on GitHub as “pages” feature. Well, no more: with the new layout, it’s now much simpler adding and editing new pages, so online documentation is now part of the main site, available here (also available via submenus in the site top menu as a convenience).

We’re proud to announce we’ve released appledoc 2.0! It took several months of efforts, but the result is stable and easily extendable platform - what we envisioned for appledoc to be in the first place!

In this post, I’ll add links to documentation generated with appledoc 2.0 in time. The post will be updated accordingly.

In the past days I’ve had an interesting e-mail interaction with a appledoc 1.0 user who had trouble with extracting documentation for methods of the first named section. Whichever section he would put first, it’s methods were not extracted. It’s a strange bug I’ve never experienced before. He even sent me an example header file and it looked correct.

In this post I’m talking about appledoc and directions I’m taking it in the future based on feedbacks and suggestions from users.