Skip to content

Conversation

unitALG
Copy link
Contributor

@unitALG unitALG commented Sep 18, 2025

Description

I included a number of small fixes from several Jira feedback tickets:

  • DOCATT-8541: Added clarification to the example comments in InputInteractionContext.SetTimeout that Started() needs to be called before SetTimeout(), as requested via user feedback.
  • DOCATT-8611: Filtered out the docs for the internal platformUserAccountXXX properties and the FindUserByAccount method on the InputUser struct. These were not documented, but DocFx still generates empty documentation for them unless they are explicitly filtered out.
  • DOCATT-8610: Clarified that disabling the action can result when DisableJoining is called on an action that was joined with the JoinPlayersWhenJoinActionIsTriggered behavior, as discussed with @ritamerkl on the input-team channel. Also added doc for JoinPlayersWhenJoinActionIsTriggered value itself.
  • DOCATT-8558: Updated the RebindingOperation class example with a local variable in OnClick(), as requested via user feedback.
  • DOCATT-8557: Removed sentence in samplingFrequency with QuerySamplingFrequencyCommand link because it is internal and shouldn't be exposed, as discussed with @ritamerkl on the input-team channel.

Testing status & QA

  • Generated documentation locally to confirm changes.

Overall Product Risks

Very low risk: documentation changes only.

Comments to reviewers

I added the 3 reviewers who contributed the last time. Please let me know if I am missing anyone.

Checklist

Before review:

  • I didn't add a changelog entry since the fixes were fairly minor, but I wasn't sure whether I should have added one for removing the user handle properties and the method. Please let me know if you would prefer me to add one.
  • No Tests added/changed (not applicable).

During merge:

  • Commit message for squash-merge is prefixed with DOCS: ___

After merge:

  • No forward/backward port needed.

@codecov-github-com
Copy link

codecov-github-com bot commented Sep 18, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

@@             Coverage Diff             @@
##           develop    #2240      +/-   ##
===========================================
- Coverage    76.70%   76.70%   -0.01%     
===========================================
  Files          465      465              
  Lines        87919    87919              
===========================================
- Hits         67442    67436       -6     
- Misses       20477    20483       +6     
Flag Coverage Δ
inputsystem_MacOS_2021.3 5.91% <ø> (ø)
inputsystem_MacOS_2021.3_project 78.05% <ø> (ø)
inputsystem_MacOS_2022.3_project 74.58% <ø> (ø)
inputsystem_MacOS_6000.0 5.19% <ø> (ø)
inputsystem_MacOS_6000.0_project 76.50% <ø> (ø)
inputsystem_MacOS_6000.2 5.19% <ø> (ø)
inputsystem_MacOS_6000.2_project 76.50% <ø> (ø)
inputsystem_MacOS_6000.3 5.19% <ø> (ø)
inputsystem_MacOS_6000.3_project 76.50% <ø> (ø)
inputsystem_MacOS_6000.4 5.19% <ø> (ø)
inputsystem_MacOS_6000.4_project 76.50% <ø> (ø)
inputsystem_Ubuntu_2021.3 5.91% <ø> (ø)
inputsystem_Ubuntu_2021.3_project 77.96% <ø> (ø)
inputsystem_Ubuntu_2022.3 5.38% <ø> (ø)
inputsystem_Ubuntu_2022.3_project 74.39% <ø> (ø)
inputsystem_Ubuntu_6000.0 5.19% <ø> (ø)
inputsystem_Ubuntu_6000.0_project 76.32% <ø> (ø)
inputsystem_Ubuntu_6000.2 5.19% <ø> (ø)
inputsystem_Ubuntu_6000.2_project 76.32% <ø> (ø)
inputsystem_Ubuntu_6000.3 5.19% <ø> (ø)
inputsystem_Ubuntu_6000.3_project 76.31% <ø> (ø)
inputsystem_Ubuntu_6000.4 5.19% <ø> (ø)
inputsystem_Ubuntu_6000.4_project 76.31% <ø> (-0.01%) ⬇️
inputsystem_Windows_2021.3 5.91% <ø> (ø)
inputsystem_Windows_2021.3_project 78.20% <ø> (ø)
inputsystem_Windows_2022.3 5.37% <ø> (ø)
inputsystem_Windows_2022.3_project 74.72% <ø> (ø)
inputsystem_Windows_6000.0 5.19% <ø> (ø)
inputsystem_Windows_6000.0_project 76.64% <ø> (ø)
inputsystem_Windows_6000.2 5.19% <ø> (ø)
inputsystem_Windows_6000.2_project 76.64% <ø> (ø)
inputsystem_Windows_6000.3 5.19% <ø> (ø)
inputsystem_Windows_6000.3_project 76.64% <ø> (+<0.01%) ⬆️
inputsystem_Windows_6000.4 5.19% <ø> (ø)
inputsystem_Windows_6000.4_project 0.00% <ø> (-76.65%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
...utSystem/Actions/InputActionRebindingExtensions.cs 82.96% <ø> (ø)
...tem/InputSystem/Actions/InputInteractionContext.cs 67.21% <ø> (ø)
...om.unity.inputsystem/InputSystem/Devices/Sensor.cs 99.53% <ø> (ø)
...utSystem/Plugins/PlayerInput/PlayerInputManager.cs 70.69% <ø> (ø)
...inputsystem/InputSystem/Plugins/Users/InputUser.cs 86.98% <ø> (ø)

... and 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

/// Note that when setting sampling frequencies, there may be limits on the range of frequencies
/// supported by the underlying hardware/platform.
///
/// To support querying sampling frequencies, a sensor device must implement <see cref="QuerySamplingFrequencyCommand"/>.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Why is this line removed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I removed that line because we don't document that command because it's internal. Users get frustrated when we recommend using something but they can't find it. I confirmed with @ritamerkl that it was ok to remove that line in a Slack thread on the input-team channel.

/// Inhibit players from joining the game.
/// </summary>
/// <remarks>
/// Note that this method might disable the action, depending on how the action
Copy link
Collaborator

Choose a reason for hiding this comment

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

I assume this meant to say "depending on how the player joined..." instead

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed wording. Thanks for catching that!

Copy link
Collaborator

@ritamerkl ritamerkl left a comment

Choose a reason for hiding this comment

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

Nothing other than what Paulius already mentioned. The rest looks good to me.

@Pauliusd01 Pauliusd01 self-requested a review September 22, 2025 05:59
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.

3 participants