BabylonJS is a fast growing framework - constantly getting new features. What I have noticed is that many questions are answered by upgrading BabylonJS and it’s hard to follow even from what’s new sometimes and I end up searching git file history. There is a JSDoc tag
@since that is intended to address exactly that. It’s only intended for classes and methods, I believe, but at least that would answer a lot of questions. Maybe it would just pollute the code? Here is an example:
I have seen a typedoc plugin that allows multiple version API document creation - this would allow a version 4.1 API documentation (would exclude @since 4.2+) and a 4.2 (would include @since 4.2). Browsing current API docs you don’t really know if it’s 4.1 or 4.2.
Even if it didn’t make it into the TypeDoc, I did a test and it came through in the typings:
It’s really helpful in other languages like Java, which has an @since. Here is the JSDoc official: