After PR review no. 1

Author: Frank Robijn

README.md

@@ -506,17 +506,7 @@ nanoff --clearcache
 
 ## Firmware archive
 
-By default, *nanoff* is designed to work with the latest version of the tool itself and of the firmware packages published in the online firmware repository. Command line arguments like
-
-```console
-nanoff --nanodevice --update --serialport COM9
-```
-
-will cause *nanoff* to check whether an update of the tool is available, download and deploy the latest version of the firmware for the connected device. This firmware has to match the NuGet packages used in the .NET **nanoFramework** applications, that may have to be updated to the latest version as well.
-
-For some projects auto-updating of tools, firmware and NuGet packages is not desirable, and a more controlled transition to new versions of the framework components is required. This can be done by downloading the firmware packages to a firmware archive location first, and then updating a nanoDevice's firmware from that archive. See the [documentation](https://docs.nanoframework.net/content/getting-started-guides/getting-started-versioning.html) for a more detailed description.
-
-Firmware can be archived via the *--updatefwarchive* option, e.g.:
+By default, *nanoff* uses the online repository to look for firmware packages. It is also possible to use a local directory as the source of firmware. The firmware archive can be populated via the *--updatefwarchive* option:
 
 ```console
 nanoff --updatefwarchive --target ESP32_S3_ALL --fwarchivepath c:\...\firmware 
@@ -527,14 +517,17 @@ For a list of archived firmware:
 ```console
 nanoff --listtargets --fromfwarchive --fwarchivepath c:\...\firmware
 ```
-where the option *--suppressnanoffversioncheck* can be added to suppress the check for an update of *nanoff*.
 
-To install firmware on a device, use the same command line arguments as usual, but add *--fromfwarchive*, *--fwarchivepath* and optionally *--suppressnanoffversioncheck*, e.g.:
+To install firmware on a device, use the same command line arguments as usual, but add *--fromfwarchive* and *--fwarchivepath*:
 
 ```console
 nanoff --nanodevice --update --serialport COM9 --fromfwarchive --fwarchivepath c:\...\firmware
 ```
 
+## Bypass version check
+
+By default nanoff checks whether a new version of the tool has been published. If that is not necessary, the option *--suppressnanoffversioncheck* can be added to suppress the check.
+
 ## Exit codes
 
 The exit codes can be checked in [this source file](https://github.com/nanoframework/nanoFirmwareFlasher/blob/main/nanoFirmwareFlasher.Library/ExitCodes.cs).

nanoFirmwareFlasher.Library/FirmwareArchiveManager.cs

@@ -10,18 +10,14 @@
 namespace nanoFramework.Tools.FirmwareFlasher
 {
     /// <summary>
-    /// The manager of a firmware archive directory. By default, all firmware is downloaded from the online
-    /// CloudSmith repository or obtained from a global cache. In general the latest version is used. As a result,
-    /// subsequent executions of the nanoFirmwareFlasher may yield different versions of the firmware.
-    /// The nanoFirmwareFlasher can be used to create a snapshot of firmware packages at a particular moment
-    /// and use the snapshot as were it the online repository, by storing the snapshot in the firmware archive directory.
-    /// The <see cref="FirmwareArchiveManager"/> implements listing, storing and retrieving of firmware in that directory.
+    /// The manager of a firmware archive directory. It supports downloading firmware packages and the runtimes
+    /// for the Virtual Device to a local directory from the online archive. That directory can then be used as
+    /// a source for list and deployment operations instead of the online archive.
     /// </summary>
     public sealed class FirmwareArchiveManager
     {
-        #region Fields
         private readonly string _archivePath;
-        #endregion
+        private const string INFOFILE_EXTENSION = ".json";
 
         #region Construction
         /// <summary>
@@ -189,7 +185,6 @@ private sealed class PersistedPackageInformation : CloudSmithPackageDetail
             /// </summary>
             public bool IsPreview { get; set; }
         }
-        private const string INFOFILE_EXTENSION = ".json";
         #endregion
 
         #region Firmware package