Godot version:
3.1.1
Issue description:
In class reference, when doc mentions return value, it sometimes says "return" and sometimes "returns". Like, half of the times for each. IMO it should always be the latter.
It's mentioned in the docs but could likely be made more explicit: http://docs.godotengine.org/en/latest/community/contributing/docs_writing_guidelines.html#mention-what-methods-return-if-it-s-useful
CC @godotengine/documentation
I think it might be nice to put the Returns XXX inside the return tag.
To give an example from Sprite.xml.
Current:
<method name="get_rect" qualifiers="const">
<return type="Rect2">
</return>
<description>
Returns a Rect2 representing the Sprite's boundary relative to its local coordinates.
</description>
</method>
New:
<method name="get_rect" qualifiers="const">
<return type="Rect2">
A Rect2 representing the Sprite's boundary relative to its local coordinates.
</return>
<description>
</description>
</method>
To render as:
void get_rect()
Returns: A Rect2 representing the Sprite's boundary relative to its local coordinates.
@bojidar-bg I think that would be confusing for documentation contributors that you have both <return> and <description> tags that you can fill, especially since for most methods the only description you need is what it gives you (<return>).
Most helpful comment
@bojidar-bg I think that would be confusing for documentation contributors that you have both
<return>and<description>tags that you can fill, especially since for most methods the only description you need is what it gives you (<return>).