Move the docs for constructors and operators out of methods section #53452
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
I'm interested in improving the documentation for operators, but before I do, I think it would be a significant improvement to separate operators from regular methods. We may as well do this with constructors too. Constructors and operators are very different from regular methods, so it makes sense that they should be separate.
I'm not very familiar with this code. This PR has not been thoroughly tested, there's likely things missing, and it's likely that the code can be simplified to not have so much duplication (would involve a fair amount of refactoring though). I assume there will also need to be updates for the docs repo so that it can read these new sections (I haven't touched the Python scripts). If anyone more knowledgeable can fix any remaining issues with this, feel free to use this PR as a base.
Anyway, the basics do work. Here is an example of how Color shows up in the editor. Previously everything was all together in one "Methods" section. Now constructors and operators get their own categories.
The descriptions work too, here's the "Operator Descriptions" section (they do work, but these ones have no description).
Here's what it looks like in the XML files, there are now sections for constructors and operators: