Merge pull request #35 from MDK-Packs/final_1_66_edits

Final changes + built docs

Author: jkrech

docs/create_app.md

@@ -321,7 +321,8 @@ You can:
 
 1. Switch between [*components*](#software-components-view) and *software packs*.
 2. View only software packs that are *part of the csolution* or view *all installed packs*.
-3. Select the scope for which the software pack selection applies (solution/project/layer).
+3. Using the drop down, select the cproject/clayer scope. It always shows all packs but "highlights" (greyed) the packs
+   specified in "scope".
 4. Examine on which level the packs are references (csolution/cproject/clayer).
 5. [*Manage software packs*](#manage-software-packs).
 6. Open *related documentation*.
@@ -337,7 +338,7 @@ In the **Current References** section, you can:
 - Set the specific
   [version](https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/pdsc_package_pg.html#VersionType) for a
   pack to be used on the csolution/cproject/clayer level. Use these version specifiers:
-    - `Unspecified`: use the latest installed version of a pack
+    - `Unspecified`: use the latest installed version of a pack and the `cbuild-pack.yml` for locked versions.
     - `@`: exact version
     - `@>=`: equal or higher
     - `@^`: equal or higher with same major version
@@ -346,4 +347,8 @@ In the **Current References** section, you can:
 
 Below that, the *used pack* version is shown. It is computed from the requirements above.
 
-In the **Update Pack** section, you can see the latest installed version and check for updates.
+In the **Update Pack** section, you can see the latest installed version and check for updates. The button on the left
+is enabled when there is a more recent version of a pack installed, but the `cbuild-pack.yml` locks it to a
+smaller version. When pressing the button, the `cbuild-pack.yml` entry will be removed on save and the latest installed
+pack version will be set and used. The button to the right opens the version page of a public pack on
+[keil.arm.com](https://www.keil.arm.com/packs) which then also shows you the latest available pack version.

docs/debug.md

@@ -467,6 +467,10 @@ files in solution's `.vscode/launch.json.d/` and `.vscode/tasks.json.d/` directo
 active solution applying the same rules as above. This can be used to include solution specific content into the
 workspace configuration based on the currently used solution.
 
+!!! Note
+    To trigger an update of the `launch.json` and `tasks.json` files, press `Ctrl/Cmd+Shift+p` and select
+    **Update Debug Tasks and Launch Configurations**.
+
 ### pyOCD
 
 In the [Manage Solution](./manage_settings.md) dialog, select the one of the debug adapters named **xyz@pyOCD**:

site/create_app.html

@@ -468,7 +468,8 @@ <h3 id="software-packs">Software packs</h3>
 <ol>
 <li>Switch between <a href="#software-components-view"><em>components</em></a> and <em>software packs</em>.</li>
 <li>View only software packs that are <em>part of the csolution</em> or view <em>all installed packs</em>.</li>
-<li>Select the scope for which the software pack selection applies (solution/project/layer).</li>
+<li>Using the drop down, select the cproject/clayer scope. It always shows all packs but "highlights" (greyed) the packs
+   specified in "scope".</li>
 <li>Examine on which level the packs are references (csolution/cproject/clayer).</li>
 <li><a href="#manage-software-packs"><em>Manage software packs</em></a>.</li>
 <li>Open <em>related documentation</em>.</li>
@@ -481,7 +482,7 @@ <h4 id="manage-software-packs">Manage software packs</h4>
 <li>Set the specific
   <a href="https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/pdsc_package_pg.html#VersionType">version</a> for a
   pack to be used on the csolution/cproject/clayer level. Use these version specifiers:<ul>
-<li><code>Unspecified</code>: use the latest installed version of a pack</li>
+<li><code>Unspecified</code>: use the latest installed version of a pack and the <code>cbuild-pack.yml</code> for locked versions.</li>
 <li><code>@</code>: exact version</li>
 <li><code>@&gt;=</code>: equal or higher</li>
 <li><code>@^</code>: equal or higher with same major version</li>
@@ -491,7 +492,11 @@ <h4 id="manage-software-packs">Manage software packs</h4>
 <li>Add a pack to a csolution/cproject/clayer.</li>
 </ul>
 <p>Below that, the <em>used pack</em> version is shown. It is computed from the requirements above.</p>
-<p>In the <strong>Update Pack</strong> section, you can see the latest installed version and check for updates.</p>
+<p>In the <strong>Update Pack</strong> section, you can see the latest installed version and check for updates. The button on the left
+is enabled when there is a more recent version of a pack installed, but the <code>cbuild-pack.yml</code> locks it to a
+smaller version. When pressing the button, the <code>cbuild-pack.yml</code> entry will be removed on save and the latest installed
+pack version will be set and used. The button to the right opens the version page of a public pack on
+<a href="https://www.keil.arm.com/packs">keil.arm.com</a> which then also shows you the latest available pack version.</p>
 
             </div>
           </div><footer>

site/debug.html

@@ -673,6 +673,11 @@ <h3 id="custom-launchjson-and-tasksjson-settings">Custom <code>launch.json</code
 files in solution's <code>.vscode/launch.json.d/</code> and <code>.vscode/tasks.json.d/</code> directories are included for the
 active solution applying the same rules as above. This can be used to include solution specific content into the
 workspace configuration based on the currently used solution.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>To trigger an update of the <code>launch.json</code> and <code>tasks.json</code> files, press <code>Ctrl/Cmd+Shift+p</code> and select
+<strong>Update Debug Tasks and Launch Configurations</strong>.</p>
+</div>
 <h3 id="pyocd">pyOCD</h3>
 <p>In the <a href="manage_settings.html">Manage Solution</a> dialog, select the one of the debug adapters named <strong>xyz@pyOCD</strong>:</p>
 <p>For the <strong>Debug Interface</strong>, you can:</p>

site/index.html

@@ -272,5 +272,5 @@ <h2 id="revision-history">Revision history</h2>
 
 <!--
 MkDocs version : 1.6.1
-Build Date UTC : 2026-02-11 10:15:03.229320+00:00
+Build Date UTC : 2026-02-11 13:42:43.964232+00:00
 -->