Could we maybe get use PHPDoc to generate MediaWiki docs, so that we can compare them side-by-side.
This is an important request because (to play devil's advocate here a little bit)...
- Not be tortoise slow
Pretty sure this only matters because we do continuous integration -- we probably don't need to do this for every commit...? Maybe once a day?
In any case -- who says PHPDoc is any faster.
- Have usable search
The demo at least doesn't even offer search functionality...
But does this even matter? I would argue in favour of a independent search solution along the lines of Ohloh [1] so that we can integrate our JSDuck documentation.
- Prettier interface
Prettier does not mean more usable. Imho after playing with their online demo for 5 minutes it was *less* usable than doxygen. Additionally, if you think doxygen is ugly, we can reskin it!
~Matt Walker Wikimedia Foundation Fundraising Technology Team
On Fri, Jul 5, 2013 at 5:39 PM, Tyler Romeo tylerromeo@gmail.com wrote:
Could we maybe get use PHPDoc to generate MediaWiki docs, so that we can compare them side-by-side.
*-- * *Tyler Romeo* Stevens Institute of Technology, Class of 2016 Major in Computer Science www.whizkidztech.com | tylerromeo@gmail.com
On Fri, Jul 5, 2013 at 8:36 PM, Yuvi Panda yuvipanda@gmail.com wrote:
Hello! Our current generated documentation[1] uses doxygen, and leaves... a number of things to be desired - such as:
- Not be tortoise slow
- Have usable search
- Prettier interface
I was looking around for alternatives, and ran into phpdocumentor2[2]. The project still seems active (latest commit was 3 days ago, and for vagrant support!), and the demo was quite pretty:
http://demo.phpdoc.org/Responsive/namespaces/phpDocumentor.html
Is there any particular reason we are still sticking with doxygen? Or is it just 'someone needs to find the time to move things over to the new system'?
-- Yuvi Panda T http://yuvi.in/blog
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l