You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I know that it doesn't have official documentation but we still need to work with it. Please add currently existing properties to unblock current development:
I understand that this poses a problem for you. However, the decision to keep the typings in sync with the docs stands for three reasons:
Without the docs, I have no idea what type (or "range" of types something actually is. In this example, is the color in the color stop an object, a scenegraph.Color? Are some properties read-only? There simply is no way to know what the actual "specs" are without documentation. Experimenting around how it is simply isn't an option since I don't have the time.
There is – without documentation – no way to create the doc comments. This, however, creates inconsistency and makes the next point even bigger
The most important argument: Maintainabilitiy. Since I'm doing these typings in my spare time, it's difficult enough as it is to keep them up-to-date. And right now, it is still relatively easy as I can just look at the diff of the docs since the last time I've updated the typings and make the changes. If now, I "mix" content that's in sync with the typings and content that isn't, the typings simply become an unmaintainable mess and I'd always have to know what parts are "guess-work" and which ones are in sync.
To be honest, this is a (huge) issue of the documentation. We simply cannot know what types (or "ranges") some properties are. Therefore, I see this as an issue of the plugin-docs, and – since as soon as this gets fixed in the docs, it'll get implemented here – not as an issue with the typings. I understand that this is an issue for you, but please understand that – due to the reasoning above – I won't be able to (willingly) take the typings "out-of-sync". I can (and do) implement things which are not – by themselves – documented´, but clearly documented in another way (this, e.g., is the case for the rendition type constants – I'll fix them in the next typings release), but a completely undocumented class isn't something I can provide.
I know that it doesn't have official documentation but we still need to work with it. Please add currently existing properties to unblock current development:
The text was updated successfully, but these errors were encountered: