[wp-meta] [Making WordPress.org] #3063: Show JavaScript documentation on developer.wordpress.org

Making WordPress.org noreply at wordpress.org
Tue Aug 22 14:02:28 UTC 2017


#3063: Show JavaScript documentation on developer.wordpress.org
---------------------------+-----------------
 Reporter:  atimmer        |      Owner:
     Type:  enhancement    |     Status:  new
 Priority:  normal         |  Milestone:
Component:  Developer Hub  |   Keywords:
---------------------------+-----------------
 There is a ton of work going into making the JavaScript documentation up
 to the same standard as the PHP documentation. This is now in a state
 where we could feasibly add it to developer.wordpress.org.

 After https://core.trac.wordpress.org/ticket/41682#comment:7 has been
 merged the output is useful.

 The way the PHP function/method/hook documentation works is by parsing the
 PHP source code and creating WordPress posts for every symbol. With every
 WordPress update this process is repeated and the posts are updated. This
 makes is possible to have user contributed notes and have extra
 documentation which is edited in a backend meta field.

 This would be the way to setup the JavaScript documentation on
 developer.wordpress.org. The PHP code can be found at
 https://github.com/wordpress/phpdoc-parser. I have started a JS version on
 https://github.com/yoast/jsdoc-parser.

 I investigated several solutions into parsing the JavaScript source code
 in WordPress. I tried both https://github.com/documentationjs and
 https://esdoc.org but both of these have failings. They both have a very
 hard time handling the JavaScript structure of WordPress core. JSDoc does
 this much better. And since JSDoc switched to babylon as their JS parser
 they can handle ES201* very fine now.

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/3063>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org


More information about the wp-meta mailing list