Should we use DocBlocks or not? I used to like them a lot, and I can see where it's handy to use them for automatic documentation, but on the other hand, they take up so much space, it feels like unnecessary clutter to me now. I dunno. A file that would ordinarily be pretty short suddenly becomes quite long, with a minimum of four extra lines before every instance variable and method. Which style do you prefer?
Should we use DocBlocks or not? I used to like them a lot, and I can see where it's handy to use them for automatic documentation, but on the other hand, they take up so much space, it feels like unnecessary clutter to me now. I dunno. A file that would ordinarily be pretty short suddenly becomes quite long, with a minimum of four extra lines before every instance variable and method. Which style do you prefer?
Message class with documentation: https://gist.github.com/The-Craw/7275935
Message class without documentation: https://gist.github.com/The-Craw/7275988