getDoclets() util ignores content when on a new line about react-docgen

[levithomason]

If it is of any interest, there are some jsdoc parsers out in the wild that may save duplication of effort.

Eslint built doctrine for the valid-jsdoc and require-jsdoc rules. I tried the demo with the multiple example above and got:

{
    "description": "",
    "tags": [
        {
            "title": "example",
            "description": "Some instructions."
        },
        {
            "title": "example",
            "description": "Some other instructions."
        }
    ]
}

There are others as well, though in my estimation doctrine is the best and most maintained. Cheers!

[fkling]

Where/when are you using getDoclets? react-docgen itself doesn't actually try to parse the doclets because there are other tools out there that do a better job (as you noticed :) ).

I think getDoclets exists only for legacy reasons... you are free to use any other tool that exists if getDoclets doesn't work for you.

I don't see why react-docgen should depend on an external tool if it doesn't use it itself though...

[levithomason]

When/where...

A gulp plugin.

I don't see why react-docgen should depend on an external tool...

I originally followed this comment on #5.

Thanks for clarifying the purpose of getDoclets. Hindsight from here is clear, I'll use something like doctrine instead.

[fkling]

Ah I see, fair enough :)