Prepare ClassicSpeech 2.0 release notes and updater clarification

README.md

@@ -2,7 +2,7 @@
 
 ClassicSpeech is an NVDA add-on for configurable speech verbosity, conservative text and number processing, Web / Browse Mode tools, and same-synth Voice Profiles.
 
-> **Current release:** [ClassicSpeech 1.01](https://github.com/trssharp/classicspeech-nvda/releases/tag/v1.01) is the latest stable release. The `main` branch remains active development; commits after a release may not yet have completed live NVDA validation.
+> **Current release:** Download the [latest stable ClassicSpeech release](https://github.com/trssharp/classicspeech-nvda/releases/latest). The `main` branch remains active development; commits after a release may not yet have completed live NVDA validation.
 
 ## Settings access
 
@@ -35,7 +35,7 @@ Position announcements are separate from the Position token and are set per verb
 
 The Intermediate profile leaves Description and Hotkey off by default. You can change these choices in **General Settings → Verbosity**.
 
-**Read edit field contents when focused**, also in **General Settings → Verbosity**, is on for every profile by default. Moving to an edit field then speaks its current line, or "blank" when it is empty, as NVDA does natively. Clear it to hear only selected text, which was the behavior before 1.02.
+**Read edit field contents when focused**, also in **General Settings → Verbosity**, is on for every profile by default. Moving to an edit field then speaks its current line, or "blank" when it is empty, as NVDA does natively. Clear it to hear only selected text, which was the behavior in 1.01.
 
 ### Voice Profiles
 

_speech_core/update_check.py

@@ -389,9 +389,16 @@ def _checked(self, outcome, version, repository, manual):
 		release = outcome
 		if not is_newer(release.version, version):
 			if manual:
-				self._message(
-					_("ClassicSpeech is up to date. You have version {version}, the latest release.").format(version=version)
-				)
+				if is_newer(version, release.version):
+					message = _(
+						"You have ClassicSpeech {version}. The latest published release is {latest}. "
+						"Your installed version is newer; no update is available."
+					).format(version=version, latest=release.version)
+				else:
+					message = _(
+						"ClassicSpeech is up to date. You have version {version}, the latest release."
+					).format(version=version)
+				self._message(message)
 			return
 		self._offer(release, version, repository)
 

doc/en/readme.html

@@ -590,7 +590,14 @@ <h3 id="assigning-gestures">Assigning gestures</h3>
 <h2 id="updates">Updating ClassicSpeech</h2>
 <p>ClassicSpeech can check for a newer version on the GitHub page it comes from: the releases of the page shown as its homepage in NVDA's Add-on Store. A copy of ClassicSpeech without a GitHub homepage can't check. Check for Updates says so, and automatic checks don't run.</p>
 <ul>
-<li>To check now, press <kbd>NVDA+N</kbd>, then choose Preferences, then ClassicSpeech, then <strong>Check for Updates...</strong>. You can also assign a gesture to the <strong>Checks for ClassicSpeech updates</strong> command. You hear "Checking for ClassicSpeech updates", then a message says whether ClassicSpeech is up to date.</li>
+<li><p>To check now, press <kbd>NVDA+N</kbd>, then choose Preferences, then ClassicSpeech, then <strong>Check for Updates...</strong>. You can also assign a gesture to the <strong>Checks for ClassicSpeech updates</strong> command. You hear "Checking for ClassicSpeech updates", then a message says whether ClassicSpeech is up to date.</p>
+<p>The updater checks GitHub's latest published regular release. Draft releases, prereleases and ordinary workflow build artifacts are not offered. It compares version numbers, not the contents of the installed package:</p>
+<ul>
+<li>If the published version is newer, it offers the update.</li>
+<li>If the versions match, it reports that ClassicSpeech is up to date. A changed package published with the same version number is not offered again.</li>
+<li>If your installed version is newer, for example a local 2.0 build while GitHub still publishes 1.01, it reports both versions and explains that no update is available. This does not mean your local build has been published.</li>
+</ul>
+<p>To replace a local build with a published package of the same version, download and open the published add-on file yourself. Date-and-run development builds also compare numerically and may be ahead of regular release versions; install a regular release manually when switching back from such a build.</p></li>
 <li>With <strong>Check for ClassicSpeech updates automatically</strong> checked on the <a href="#advanced">Advanced</a> page, ClassicSpeech checks once a day, about 30 seconds after NVDA starts. It says nothing unless there is an update.</li>
 </ul>
 <p>When a newer version is available, a dialog opens. It says which version you have and which version is available, and then holds the new release's notes in a box called <strong>What's new</strong>.</p>