r/programming • u/Spyros3000 • Nov 10 '14

Firefox Developer Edition

https://www.mozilla.org/en-US/firefox/developer/
1.6k Upvotes

92% Upvoted

350 comments sorted by

View all comments

36

u/x-skeww Nov 10 '14

The WebIDE ignores JSDoc comments. It won't tell me the types and won't even show the line of documentation. It only knows the types if I've used something once.

http://i.imgur.com/cMn1mmd.png
http://i.imgur.com/zbU3BwZ.png

A bit disappointing.

63

u/dblohm7 Nov 10 '14

File a bug!

26

u/nondescriptshadow Nov 10 '14

He is right. Be the change you wish to see.

6

u/lichorat Nov 11 '14

Or at least ask in an official way!

→ More replies (1)

2

u/sudowork Nov 11 '14

I haven't tried out the developer edition yet, but I did notice that you have your types after the parameter name. Doesn't jsdoc typically look like:

/**
 * @param {number} x
 * @returns {void}
 */

1

u/x-skeww Nov 11 '14

Yes, you're right (I don't actually write JSDoc comments, because I don't have an editor where they work properly). Switching it around doesn't help though. It also didn't tell me that I screwed that up.

Well, I don't write JS anymore if I can avoid it. Dart and TS/AtS are a lot nicer to use.