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

Remove a demo script #15904

Merged
merged 2 commits into from Dec 13, 2023
Merged

Remove a demo script #15904

merged 2 commits into from Dec 13, 2023

Conversation

CyrilleB79
Copy link
Collaborator

@seanbudd, feel free to merge or to close without merging, depending on your answer to #11465 (comment).

Link to issue number:

Closes #11465

Summary of the issue:

NVDAObjects\IAccessible\winword.py contains a script that is not documented (no input help, not mentioned in user Guide). It has been introduced in commit 465dce8 when #3110 has been implemented as a demo script to test the new headers reading capability.

This script cause an error in the log when called outside of a table.

Description of user facing changes

No more error when pressing NVDA+shift+H in Word document.

Description of development approach

Just removed the script.

Testing strategy:

Tested that NVDA+shift+H does not produce any error in Word document.

Known issues with pull request:

This script is probably used by nobody since it is undocumented: it does not appear in input help, nor in input gesture dialog, nor in User Guide. Anyway, we cannot exclude 100% that someone uses this undocumented and unadvertised feature.
If it is the case, let's hope that this person will make a feedback to explain their need.

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

For information

Cc @michaelDCurran, in case you have something to say since you were the one who had introduced this script.

@CyrilleB79 CyrilleB79 marked this pull request as ready for review December 11, 2023 14:15
@CyrilleB79 CyrilleB79 requested a review from a team as a code owner December 11, 2023 14:15
@seanbudd
Copy link
Member

Can you please add a change log entry as this is an API breaking change. I think this is sufficient documentation of the change.

@seanbudd seanbudd added this to the 2024.1 milestone Dec 12, 2023
@CyrilleB79
Copy link
Collaborator Author

Can you please add a change log entry as this is an API breaking change. I think this is sufficient documentation of the change.

Yes, makes sense.

Change log added in ea4c142. I have used the PR's number rather than the one of the issue. Unless the issue describes a code design change (e.g. speech refactor), I prefer put the issue number in the firsts paragraphs of the change log, but the PR number in the paragraph "Changes for developers" and its sub-paragraph.

@seanbudd seanbudd merged commit 966fffb into nvaccess:master Dec 13, 2023
1 check passed
@CyrilleB79 CyrilleB79 deleted the removeDebugScript branch January 8, 2024 12:36
Adriani90 pushed a commit to Adriani90/nvda that referenced this pull request Mar 13, 2024
Link to issue number:
Closes nvaccess#11465

Summary of the issue:
NVDAObjects\IAccessible\winword.py contains a script that is not documented (no input help, not mentioned in user Guide). It has been introduced in commit 465dce8 when nvaccess#3110 has been implemented as a demo script to test the new headers reading capability.

This script cause an error in the log when called outside of a table.

Description of user facing changes
No more error when pressing NVDA+shift+H in Word document.

Description of development approach
Just removed the script.
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.

Error in MS Word when pressing nvda+shift+h
2 participants