Your code is meant to be read and written by humans. While it should be syntactically correct to compile, your naming conventions, comments, and other artifacts of your coding style are of no importance to the compiler. The level of detail and attention you will put into documenting your code can make all the difference to internal or external contributors.
If you honed your craft on Objective-C, you’re not in luck. Apple, which for the longest time used HeaderDoc, switched to a Markdown-flavored documentation engine. This is for the better, as Markdown is a widely used markup language and you will feel right at home if you have any experience with it.
