Skip to content

Conversation

@jfreire-unity
Copy link
Collaborator

@jfreire-unity jfreire-unity commented Jan 11, 2024

Description

https://jira.unity3d.com/browse/ISX-1694

Changes made

Update public docs with changes made in #1807.

Notes

Might need an additional iteration on the whole docs. I did the minimum I believe is needed to be done. Feel free to edit this PR to change the docs. cc @duckets

Also, I believe there are some updates to be done by the UI team in https://docs.unity3d.com/Manual/UIE-Runtime-Event-System.html. I have informed them.

Checklist

Before review:

  • Changelog entry added.
    • Explains the change in Changed, Fixed, Added sections.
    • For API change contains an example snippet and/or migration example.
    • FogBugz ticket attached, example ([case %number%](https://issuetracker.unity3d.com/issues/...)).
    • FogBugz is marked as "Resolved" with next release version correctly set.
  • Tests added/changed, if applicable.
    • Functional tests Area_CanDoX, Area_CanDoX_EvenIfYIsTheCase, Area_WhenIDoX_AndYHappens_ThisIsTheResult.
    • Performance tests.
    • Integration tests.
  • Docs for new/changed API's.
    • Xmldoc cross references are set correctly.
    • Added explanation how the API works.
    • Usage code examples added.
    • The manual is updated, if needed.

During merge:

  • Commit message for squash-merge is prefixed with one of the list:
    • NEW: ___.
    • FIX: ___.
    • DOCS: ___.
    • CHANGE: ___.
    • RELEASE: 1.1.0-preview.3.

Copy link
Collaborator

@lyndon-unity lyndon-unity left a comment

Choose a reason for hiding this comment

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

Small changed needed regarding the 1.8 reference in the URL link


You can add and remove bindings as intended for you necessary functionality. However, the action map 'UI' and all of its actions must remain with the same name, otherwise the UI input will not work correctly.

The actions names are equivalent in functionality to the ones present in [InputSystemUIInputModule](../api/UnityEngine.InputSystem.UI.InputSystemUIInputModule.html).
Copy link
Collaborator

Choose a reason for hiding this comment

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

You could mention that if you accidently delete the action map, using the 'reset' button will restore the defaults (but will impact the other actions maps in the project wide input actions).

Might not be needed to be explicitly stated here.

@jfreire-unity jfreire-unity force-pushed the isx-1694-uitk-project-wide-actions-docs-update branch from 4065ffe to 7fb0239 Compare January 22, 2024 20:46
Copy link
Collaborator

@lyndon-unity lyndon-unity left a comment

Choose a reason for hiding this comment

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

Changes look good.
Happy to approve.
However there are a couple of test failures on CI - I've clicked re-run on those to move it along as it looked like potentially infrastructure issues

@lyndon-unity
Copy link
Collaborator

Changes look good. Happy to approve. However there are a couple of test failures on CI - I've clicked re-run on those to move it along as it looked like potentially infrastructure issues

Looks like develop is failing the same issue so not new in this PR
https://unity-ci.cds.internal.unity3d.com/job/33329901/logs

@lyndon-unity lyndon-unity removed the request for review from benoit-alain January 24, 2024 10:23
@lyndon-unity
Copy link
Collaborator

Benoit Approved via slack due to login issues.

Copy link
Collaborator

@lyndon-unity lyndon-unity left a comment

Choose a reason for hiding this comment

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

Generally good - but I'd advise one small change.


![ProjectSettingsInputActionsUIActionMap](Images/ProjectSettingsInputActionsUIActionMap.png)

You can modify, add, or remove bindings to the named actions in the UI action map to suit your project, however in order to remain compatible with UI Toolkit, the name of the action map ("UI") and the names of the actions it contains ("Navigate", "Submit", "Cancel", etc) must remain the same. This is because the actions names match the action property names in the [UI Input Module](../api/UnityEngine.InputSystem.UI.InputSystemUIInputModule.html) class.
Copy link
Collaborator

Choose a reason for hiding this comment

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

This part isn't quite right - I think you can drop the ' This is because' part and it would be more correct.

This is because the actions names match the action property names in the UI Input Module class.

The are the same but that';s not what we are matching against.

Copy link
Collaborator

Choose a reason for hiding this comment

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

An attempt to modify this is coming in pending commit.

@ekcoh
Copy link
Collaborator

ekcoh commented Jan 29, 2024

I will try to pick up this PR from @jfreire-unity

@ekcoh ekcoh removed their request for review January 29, 2024 12:47
Copy link
Collaborator

@lyndon-unity lyndon-unity left a comment

Choose a reason for hiding this comment

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

I'm happy with that update

@ekcoh ekcoh merged commit d1db8c6 into develop Jan 29, 2024
@ekcoh ekcoh deleted the isx-1694-uitk-project-wide-actions-docs-update branch January 29, 2024 18:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants