I’ve done a fair bit of development in Visual Studio and Eclipse over the years. One of the feature of those IDEs have that XCode strangely lacks is the ability to automatically generate a decent doc comment for a method.

After a bit of googling today I cam across the VVDocumenter plugin for XCode that does exactly what I want. Well worth a look if you want to get into the habit of documenting your code properly. The article linked below provides everything you need to get started with it.

How to Generate Beautiful Apple-Style Documentation in Xcode 5 | Objective C#.