Closed cfoellmann closed 9 years ago
They're both good ideas. In particular I like the inline DocBlocks. As for comments indicating endings I think they're useful especially when there are big blocks of code or multiple levels of nested code. After the recent refactor there should be no more such big chunks of code difficult to be read, so probably the ending comments wouldn't be so much useful as they would have been before. Anyway I am not against them, so if you'll take the time to add them, I will merge. Thank you.
Completed with 4241417731538ad96c4184a342929d4037e971f5. Thank you!
I have a few docs related "ideas" I would like to pitch to you. What do you think about these? If you like it I can send you PRs.
Comment indicating endings like:
Extended DocBlock documentation for functions (NetBeans detects a lot of this stuff). Like: