Hi! > I used Doxygen in both PRs to document the code. Right now the code base > is lacking a lot of documentation, which, if done right, would greatly > improve accessibility of the code base.
Well, the problem as I understand it is that we don't have Doxygen setup for docs generation. So, adding docs in Doxygen format is not very useful, until we get some Doxygen setup. If we don't get one, then I think it's better to use format that is either completely generic (no special tags, etc.) or matching existing usage. Or make an RFC to establish docs standard, be it Doxygen or anything else. Which of course would include some plan on how to deploy that system. But randomly introducing docs system without any explicit decision in an unrelated patch doesn't look like a good idea to me. -- Stas Malyshev smalys...@gmail.com -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
