Merge a5a7450 into 236ff8e

seanbudd · web-flow · commit f228b69e3af4 · 2023-07-26T12:57:58.000+10:00
diff --git a/devDocs/userGuideStandards.md b/devDocs/userGuideStandards.md
@@ -13,7 +13,7 @@ The principles outlined in ["The Documentation System" guide for reference mater
 
 ## Feature settings
 
-Feature flags should be included using the following format.
+Feature flags, comboboxes and checkboxes should be included using the following format.
 
 `FeatureDescriptionAnchor` should not include the settings category.
 Once the anchor is set it cannot be updated, while settings may move categories.
@@ -28,4 +28,4 @@ Once the anchor is set it cannot be updated, while settings may move categories.
 
 This setting allows the feature of using functionality in a certain situation to be controlled in some way.
 If necessary, a description of a common use case that is supported by each option.
-```
+```
diff --git a/user_docs/en/changes.t2t b/user_docs/en/changes.t2t
@@ -5,6 +5,17 @@ What's New in NVDA
 %!includeconf: ./locale.t2tconf
 
 = 2023.2 =
+This release introduces the Add-on Store to replace the Add-ons Manager.
+In the Add-on Store you can browse, search, install and update community add-ons.
+You can now manually override incompatibility issues with outdated add-ons at your own risk.
+
+There are new Braille features, commands, and display support.
+There are also new input gestures for OCR and flattened object navigation.
+Navigating and reporting formatting in Microsoft Office is improved.
+
+There are many bug fixes, particularly for Braille, Microsoft Office, web browsers and Windows 11.
+
+eSpeak-NG, LibLouis Braille translator, and Unicode CLDR have been updated.
 
 == New Features ==
 - Add-on Store has been added to NVDA. (#13985)
@@ -32,17 +43,17 @@ What's New in NVDA
   Please refer to the NVDA User Guide for a full list. (#14714)
   -
 - Added pronunciation of Unicode symbols:
-  - braille symbols such as "⠐⠣⠃⠗⠇⠐⠜". (#14548)
-  - Mac Option key symbol "⌥". (#14682)
+  - Braille symbols such as ``⠐⠣⠃⠗⠇⠐⠜``. (#13778)
+  - Mac Option key symbol ``⌥``. (#14682)
   -
 - Added gestures for Tivomatic Caiku Albatross Braille displays. (#14844, #15002)
-  - showing the braille settings dialog
+  - showing the Braille settings dialog
   - accessing the status bar
-  - cycling the braille cursor shape
-  - cycling the braille show messages mode
-  - toggling the braille cursor on/off
-  - toggling the "braille show selection indicator" state
-  - cycling the "braille move system caret when routing review cursor" mode. (#15122)
+  - cycling the Braille cursor shape
+  - cycling the Braille show messages mode
+  - toggling the Braille cursor on/off
+  - toggling the "Braille show selection indicator" state
+  - cycling the "Braille move system caret when routing review cursor" mode. (#15122)
   -
 - Microsoft Office features:
   - When highlighted text is enabled Document Formatting, highlight colours are now reported in Microsoft Word. (#7396, #12101, #5866)
@@ -58,49 +69,53 @@ What's New in NVDA
     -
   - There is a known issue with intermittent crashing when WASAPI is enabled. (#15150)
   -
-- In Mozilla Firefox and Google Chrome, NVDA now reports when a control opens a dialog, grid, list or tree if the author has specified this using aria-haspopup. (#14709)
+- In Mozilla Firefox and Google Chrome, NVDA now reports when a control opens a dialog, grid, list or tree if the author has specified this using ``aria-haspopup``. (#8235)
 - It is now possible to use system variables (such as ``%temp%`` or ``%homepath%``) in the path specification while creating portable copies of NVDA. (#14680)
 - In Windows 10 May 2019 Update and later, NVDA can announce virtual desktop names when opening, changing, and closing them. (#5641)
 - A system wide parameter has been added to allow users and system administrators to force NVDA to start in secure mode. (#10018)
 - 
 
 
 == Changes ==
-- eSpeak NG has been updated to 1.52-dev commit ``ed9a7bcf``. (#15036)
-- Updated LibLouis braille translator to [3.26.0 https://github.com/liblouis/liblouis/releases/tag/v3.26.0]. (#14970)
-- CLDR has been updated to version 43.0. (#14918)
-- Dash and em-dash symbols will always be sent to the synthesizer. (#13830)
+- Component updates:
+  - eSpeak NG has been updated to 1.52-dev commit ``ed9a7bcf``. (#15036)
+  - Updated LibLouis Braille translator to [3.26.0 https://github.com/liblouis/liblouis/releases/tag/v3.26.0]. (#14970)
+  - CLDR has been updated to version 43.0. (#14918)
+  -
 - LibreOffice changes:
-  - When reporting the review cursor location, the current cursor/caret location is now reported relative to the current page in LibreOffice Writer for LibreOffice versions >= 7.6, similar to what is done for Microsoft Word. (#11696)
+  - When reporting the review cursor location, the current cursor/caret location is now reported relative to the current page in LibreOffice Writer 7.6 and newer, similar to what is done for Microsoft Word. (#11696)
   - Announcement of the status bar (e.g. triggered by ``NVDA+end``) works for LibreOffice. (#11698)
+  - When moving to a different cell in LibreOffice Calc, NVDA no longer incorrectly announces the coordinates of the previously focused cell when cell coordinate announcement is disabled in NVDA's settings. (#15098)
+  -
+- Braille changes:
+  - When using a Braille Display via the Standard HID Braille driver, the dpad can be used to emulate the arrow keys and enter.
+  Also ``space+dot1`` and ``space+dot4`` now map to up and down arrow respectively. (#14713)
+  - Updates to dynamic web content (ARIA live regions) are now displayed in Braille.
+  This can be disabled in the Advanced Settings panel. (#7756)
   -
+- Dash and em-dash symbols will always be sent to the synthesizer. (#13830)
 - Distance reported in Microsoft Word will now honour the unit defined in Word's advanced options even when using UIA to access Word documents. (#14542)
 - NVDA responds faster when moving the cursor in edit controls. (#14708)
-- When using a Braille Display via the Standard HID braille driver, the dpad can be used to emulate the arrow keys and enter.
-Also ``space+dot1`` and ``space+dot4`` now map to up and down arrow respectively. (#14713)
 - Script for reporting the destination of a link now reports from the caret / focus position rather than the navigator object. (#14659)
-- Portable copy creation no longer requires that a drive letter be entered as part of the absolute path. (#14681)
+- Portable copy creation no longer requires that a drive letter be entered as part of the absolute path. (#14680)
 - If Windows is configured to display seconds in the system tray clock, using ``NVDA+f12`` to report the time now honors that setting. (#14742)
 - NVDA will now report unlabeled groupings that have useful position information, such as in recent versions of Microsoft Office 365 menus. (#14878)
-- Updates to dynamic web content (ARIA live regions) are now displayed in Braille.
-This can be disabled in the Advanced Settings panel. (#7756)
-- When moving to a different cell in LibreOffice Calc, NVDA no longer incorrectly announces the coordinates of the previously focused cell when cell coordinate announcement is disabled in NVDA's settings. (#15098)
 -
 
 
 == Bug Fixes ==
 - Braille:
-  - Several stability fixes to input/output for braille displays, resulting in less frequent errors and crashes of NVDA. (#14627)
-  - NVDA will no longer unnecessarily switch to no braille multiple times during auto detection, resulting in a cleaner log and less overhead. (#14524)
+  - Several stability fixes to input/output for Braille displays, resulting in less frequent errors and crashes of NVDA. (#14627)
+  - NVDA will no longer unnecessarily switch to no Braille multiple times during auto detection, resulting in a cleaner log and less overhead. (#14524)
   - NVDA will now switch back to USB if a HID Bluetooth device (such as the HumanWare Brailliant or APH Mantis) is automatically detected and an USB connection becomes available.
   This only worked for Bluetooth Serial ports before. (#14524)
   -
 - Web browsers:
   - NVDA no longer occasionally causes Mozilla Firefox to crash or stop responding. (#14647)
-  - In Mozilla Firefox and Google Chrome, typed characters are no longer reported in some text boxes even when speak typed characters is disabled. (#14666)
+  - In Mozilla Firefox and Google Chrome, typed characters are no longer reported in some text boxes even when speak typed characters is disabled. (#8442)
   - You can now use browse mode in Chromium Embedded Controls where it was not possible previously. (#13493, #8553)
   - In Mozilla Firefox, moving the mouse over text after a link now reliably reports the text. (#9235)
-  - The destination of graphic links is now correctly reported in Chrome and Edge. (#14779)
+  - The destination of graphic links is now reported accurately in more cases in Chrome and Edge. (#14783)
   - When trying to report the URL for a link without a href attribute NVDA is no longer silent.
   Instead NVDA reports that the link has no destination. (#14723)
   - In Browse mode, NVDA will no longer incorrectly ignore focus moving to a parent or child control e.g. moving from a control to its parent list item or gridcell. (#14611)
@@ -115,7 +130,7 @@ This can be disabled in the Advanced Settings panel. (#7756)
   -
 - Microsoft Office fixes:
   - When rapidly moving through cells in Excel, NVDA is now less likely to report the wrong cell or selection. (#14983, #12200, #12108)
-  - When landing on an Excel cell from outside a work sheet, braille and focus highlighter are no longer needlessly updated to the object that had focus previously. (#15136)
+  - When landing on an Excel cell from outside a work sheet, Braille and focus highlighter are no longer needlessly updated to the object that had focus previously. (#15136)
   - NVDA no longer fails to announce focusing password fields in Microsoft Excel and Outlook. (#14839)
   -
 - For symbols which do not have a symbol description in the current locale, the default English symbol level will be used. (#14558, #14417)
@@ -137,11 +152,10 @@ This can be disabled in the Advanced Settings panel. (#7756)
 Please refer to [the developer guide https://www.nvaccess.org/files/nvda/documentation/developerGuide.html#API] for information on NVDA's API deprecation and removal process.
 
 - Suggested conventions have been added to the add-on manifest specification.
-These are optional for NVDA compatibility, but are encouraged or required for submitting to the add-on store.
-The new suggested conventions are:
-  - Using ``lowerCamelCase`` for the name field.
-  - Using ``<major>.<minor>.<patch>`` format for the version field (required for add-on datastore).
-  - Using ``https://`` as the schema for the url field (required for add-on datastore).
+These are optional for NVDA compatibility, but are encouraged or required for submitting to the Add-on Store. (#14754)
+  - Use ``lowerCamelCase`` for the name field.
+  - Use ``<major>.<minor>.<patch>`` format for the version field (required for add-on datastore).
+  - Use ``https://`` as the schema for the url field (required for add-on datastore).
   -
 - Added a new extension point type called ``Chain``, which can be used to iterate over iterables returned by registered handlers. (#14531)
 - Added the ``bdDetect.scanForDevices`` extension point.
diff --git a/user_docs/en/userGuide.t2t b/user_docs/en/userGuide.t2t
