DEV Community

loading...

Discussion on: The power of jsDoc

Collapse
gmartigny profile image
Guillaume Martigny Author

I like this idea of a different file for the documentation, but is that not a pain in the a** to maintain ?

Collapse
jorinvo profile image
jorin

Not more than writing other kinds of external documentation.
I think it is a nice approach for packages with a small scope, but you are right, for internal-only code I would also prefer documentation inline with code since it is easier to think about updating it.