Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tweak Joint2D and Joint3D documentation for consistency #87446

Merged
merged 1 commit into from
May 29, 2024

Conversation

Mickeon
Copy link
Contributor

@Mickeon Mickeon commented Jan 21, 2024

Small tweaks to both Joint2D and Joint3D to make the wording consistent between the two. Also makes the description of node_a and node_b less misleading.

@Mickeon Mickeon requested a review from rburing January 22, 2024 12:16
@Mickeon Mickeon removed the request for review from a team February 19, 2024 12:25
@Mickeon
Copy link
Contributor Author

Mickeon commented Feb 19, 2024

K-kindly removed the request from the documentation team. I LITERALLY AM THE DOCUMENTATION TEAM

@akien-mga
Copy link
Member

Well you'll have a hard time getting reviews without asking for reviews. The documentation team has more members than one ;)

@akien-mga akien-mga requested a review from a team February 19, 2024 13:38
</member>
<member name="node_a" type="NodePath" setter="set_node_a" getter="get_node_a" default="NodePath(&quot;&quot;)">
The first body attached to the joint. Must derive from [PhysicsBody2D].
Path to the first body (A) attached to the joint. The node must inherit [PhysicsBody2D].
If left empty and [member node_b] is set, the body hangs as if attached to an invisible [StaticBody2D].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is currently only true for PinJoint2D. See the GodotPhysicsServer2D::joint_make_* methods (in contrast to the 3D equivalents). I think we should make the implementation consistent with 3D (so this documentation description becomes true), if it makes sense.

Copy link
Contributor Author

@Mickeon Mickeon Apr 8, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Definitely. For now I can strip this detail from Joint2D but it should be the case...

doc/classes/Joint2D.xml Outdated Show resolved Hide resolved
@mhilbrunner mhilbrunner self-requested a review April 7, 2024 09:12
doc/classes/Joint3D.xml Outdated Show resolved Hide resolved
@Mickeon Mickeon force-pushed the documentation-Joint-tweaks branch from ab6022c to 4017b11 Compare April 8, 2024 14:50
@Mickeon Mickeon force-pushed the documentation-Joint-tweaks branch from 4017b11 to 0531f96 Compare April 8, 2024 14:51
@Mickeon
Copy link
Contributor Author

Mickeon commented Apr 8, 2024

Updated the PR to address the above issues, you may look again.

@akien-mga akien-mga merged commit 9b1dbd2 into godotengine:master May 29, 2024
16 checks passed
@akien-mga
Copy link
Member

Thanks!

@Mickeon Mickeon deleted the documentation-Joint-tweaks branch June 6, 2024 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants