When NVDA is started, display in braille if screen curtain is enabled

[nvdaes]

Link to issue number:

Fixes #19441

Summary of the issue:

When NVDA is started with the screen curtain enabled, optionally, NVDA can play a sound warning about this, but braille users aren't informed.

Description of user facing changes:

If screen curtain is enabled, a message displayed in braille Will report this when NVDA is started.

Description of developer facing changes:

None.

Description of development approach:

In core.py, an initialMessage variable has been created. Its value would be the current message ("NVDA started"), or a message like "NVDA started with screen curtain enabled").

Testing strategy:

I've performed two kind of tests:

• Trying to add the message in screenCurtain.py to be displayed in braille after a delay. This makes NVDA to display this message, but not the message shown when NVDA is started.
• Adding the message to core.py in a variable. This is displayed in a reliable way, according to my tests, when appropriate.

Known issues with pull request:

None.

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.

[nvdaes]

pre-commit.ci run

[nvdaes]

pre-commit.ci run

[Copilot]

Pull request overview

Adds braille feedback at startup when Screen Curtain is active, addressing a gap for braille-only users (Fixes #19441).

Changes:

• Compute a startup braille message that can include “screen curtain enabled” when appropriate.
• Add a changelog entry for the new braille feedback.
• Fix/adjust markdown list formatting in issue-reporting documentation.

Reviewed changes

Copilot reviewed 2 out of 4 changed files in this pull request and generated 2 comments.

File	Description
user_docs/en/changes.md	Documents the new braille startup indication for Screen Curtain.
source/core.py	Adds conditional startup braille message selection for Screen Curtain state.
projectDocs/issues/readme.md	Adjusts markdown list formatting in issue-reporting docs.
projectDocs/issues/githubIssueTemplateExplanationAndExamples.md	Adjusts markdown list formatting in issue template docs.

[nvdaes]

I think that, for simplicity, it's better to show the braille message when screen curtain is enabled, even if the option to play a sound is disabled.
Reasons are:

• A braille message informing that NVDA has been started will be shown anyway, so this is not an extra but just a different message.
• • It's tricky to change the label of the control including something like "sounds and braille, since the braille message won't be shown when NVDA is quit.
• • Perhaps hearing impaired (or other) people don't want to hear the sound, but a longer message in braille is not anoying and can be displayed for all users.
• • This is used just when NVDA is started, since in other cases, i.e., when screen curtain is enabled/disabled manually, a braille message will be shown.

For now I'll change this according to this comment. If needed, the last commit that I'll make now can be reverted.

[seanbudd]

Thanks @nvdaes