wordpoints
wordpoints copied to clipboard
WordPoints
Improved JS inline Docs
This is something that we might want to tackle as we improve our JS. I might punt it for now.
This is something that we should do as we go along. Closing as maybelater.
Looking at our JS while working on some recent tickets, I think that we should go ahead and make an effort to do this one release. The sooner it is done the better, as it becomes more difficult to determine version numbers as time passes.
The sooner it is done the better, as it becomes more difficult to determine version numbers as time passes.
For this reason, I think that we should go ahead and at least ad the version numbers, even if some things have to be filled out more later.
The reason that we haven't done more on this already is that I am not familiar enough with JSDoc, and WordPress's standards are kind of vague and not up-to-date. But let's just do our best, if we have to modify things later, at least the main stuff will be in place and changes will be systematic.
The JSDocs in core are getting some love now: https://core.trac.wordpress.org/changeset/41351