[Bug 64996] Doxygen documentation of Wikibase code

2014-05-08 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

Sam Reed (reedy) s...@reedyboy.net changed:

   What|Removed |Added

   Severity|normal  |enhancement

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l


[Bug 64996] Doxygen documentation of Wikibase code

2014-05-07 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

tobias.gritschac...@wikimedia.de changed:

   What|Removed |Added

   Priority|Unprioritized   |Normal
 Whiteboard||u=dev c=infrastructure p=0

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l


[Bug 64996] Doxygen documentation of Wikibase code

2014-05-07 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

TeleComNasSprVen drevit...@gmail.com changed:

   What|Removed |Added

 Blocks||1

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l


[Bug 64996] Doxygen documentation of Wikibase code

2014-05-07 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

--- Comment #1 from Thiemo Mättig thiemo.maet...@wikimedia.de ---
http://docs.wikiba.se/ sounds good. Maybe a structure like
http://docs.wikiba.se/repo/0.5/php/
http://docs.wikiba.se/repo/0.5/js/
http://docs.wikiba.se/client/0.5/php/
http://docs.wikiba.se/client/0.5/js/

Not sure if the php/js separation is needed. Is Doxygen able to process both in
a single documentation?

If this is done please create a redirect from
http://wikidata-docs.wikimedia.de/ to the new location.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l


[Bug 64996] Doxygen documentation of Wikibase code

2014-05-07 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

--- Comment #2 from Christopher Johnson christopher.john...@wikimedia.de ---
For reference, core doxygen docs are here:
https://doc.wikimedia.org/mediawiki-core/master/php/html/index.html
No JS in these docs though.  This is shown on the sidebar on
https://www.mediawiki.org/ as Code docs.  

The JS could be filtered with a second tool, like
http://svn.berlios.de/wsvn/jsunit/trunk/jsunit/util/js2doxy.pl?op=filerev=0sc=0
described here http://jsunit.berlios.de/internal.html (assuming it is
documented per Javadoc conventions).

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l


[Bug 64996] Doxygen documentation of Wikibase code

2014-05-07 Thread bugzilla-daemon
https://bugzilla.wikimedia.org/show_bug.cgi?id=64996

--- Comment #3 from Christopher Johnson christopher.john...@wikimedia.de ---
Note that WB code has not yet implemented doc groups/modules (unlike core).
See http://www.stack.nl/~dimitri/doxygen/manual/grouping.html

May want to consider adding this rather than splitting up into separate doc
builds.

See http://wbdoc.wmflabs.org/ for bundled Wikibase build documentation test. 

Check http://wbdoc.wmflabs.org/doxygen.log for warnings.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
___
Wikibugs-l mailing list
Wikibugs-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikibugs-l