union types should be added to commentary?

dart-archive / custom-element-apigen

Tool to generate Dart APIs for polymer custom elements written in Javascript

BSD 3-Clause "New" or "Revised" License

13 stars 13 forks source link

union types should be added to commentary? #6

Open sigmundch opened 10 years ago

sigmundch commented 10 years ago

from: https://github.com/dart-lang/core-elements/issues/9

Until this bug is fixed: https://code.google.com/p/dart/issues/detail?id=4938 we can't represent union types in Dart, so we'd need to include them in a doc comment if we want to keep that level of precision.

personally, I'm not sure this is worth it. I'd rather redesign APIs to avoid union types where it makes sense.