And here I have two things to say. First, I really like the animation of the documentation being added to the source code, I find it really beautiful! But also, I would advise caution about using this feature too much. Because, when you think about it, the fact that we can now ask for on-demand documentation makes you wonder if it really makes sense to save that documentation in the source code, where it runs the risk of becoming outdated over time, versus just asking for it to be generated on-demand when needed. I do think this feature can be helpful if you distribute a closed-source library and want some help writing the documentation. But I definitely wouldn't recommend that you start using it to automatically document every function in your project. And I would also recommend that you carefully review what's being generated, because there's no guarantee that it will actually be correct! |