documentationjs / documentation

:book: documentation for modern JavaScript
http://documentation.js.org/
Other
5.79k stars 482 forks source link

ES6 support #29

Open jfirebaugh opened 9 years ago

jfirebaugh commented 9 years ago

Currently blocked by lack of parser support: http://esprima.org/doc/es6.html

Running list of things to support:

tmcw commented 9 years ago

Looks like espree does this better and doesn't break from the AST tradition like babel does

mourner commented 9 years ago

+1 for Espree http://eslint.org/blog/2014/12/espree-esprima/

tmcw commented 7 years ago

This will be actionable once #732 is merged, and I'll write a thorough summary for help wanted.

tmcw commented 7 years ago

I first dove in on trying to solve

function a(b /** this would have docs in it */) {}

But this is unfortunately tricky. We prefer to parse comments as leadingComments first, and that comment is a leading comment for the function body as well as a trailing comment for the param a.

Destructuring patterns don't have this problem. Looking into them.