[version-4-0] docs: address tutorial suggestions (#3980) (#4021)

* docs: address tutorial suggestions (#3980)

* docs: address tutorial suggestions

* docs: vale suggestion

* Optimised images with calibre/image-actions

* Optimised images with calibre/image-actions

---------

Co-authored-by: vault-token-factory-spectrocloud[bot] <133815545+vault-token-factory-spectrocloud[bot]@users.noreply.github.com>
(cherry picked from commit 8ea96da)

* retrigger build

* docs: fix gitleaks

---------

Co-authored-by: caroldelwing <[email protected]>

.gitleaksignore

@@ -139,3 +139,4 @@ e4040084011d4d7935a589959b96ebc5cfba7a94:docs/docs-content/integrations/kubernet
 8f515d46ce2bb80b7173bf9684ed8e87cb96fd83:docs/docs-content/tutorials/edge/deploy-cluster-virtualbox.md:generic-api-key:229
 732cee5bed26e19ab178d822352de641a924e3b6:docs/docs-content/tutorials/edge/deploy-cluster-virtualbox.md:generic-api-key:187
 740c00193f308cecd7daebc2e2424702a3fbb944:docs/docs-content/integrations/kubernetes.md:generic-api-key:1005
+a43d695980eb29b9d3201b6a4143d8090aeeb771:docs/docs-content/tutorials/edge/deploy-cluster-virtualbox.md:generic-api-key:187

docs/docs-content/tutorials/profiles/deploy-pack.md

@@ -5,6 +5,7 @@ description:
   "Learn how to deploy applications to a Kubernetes cluster using Palette's custom packs, hosted in either the Spectro
   registry or an OCI registry."
 sidebar_position: 0
+toc_max_heading_level: 2
 tags: ["packs", "tutorial"]
 category: ["tutorial"]
 ---
@@ -361,6 +362,13 @@ Next, export the variables below, which you will use later to create the ECR rep
 - `VERSION` - the pack's version, which must match the version in the **pack.json** file.
 - `ACCOUNT_ID` - your AWS account ID, containing only numerical digits and no dashes.
 
+:::warning
+
+Ensure that the variables `NAME` and `VERSION` match the pack name and version in the **pack.json** file. This is a
+requirement for the pack to be correctly pushed to the registry.
+
+:::
+
 ```bash
 export REGISTRY_NAME=spectro-oci-registry
 export NAME=hellouniverse
@@ -470,9 +478,16 @@ Login Succeeded
 
 After you have created the repositories, authenticate to your ECR registry using the `aws ecr get-login-password`
 command. The ECR authorization token is then passed to the `oras login` command with **AWS** as username and the
-registry Uniform Resource Identifier (URI). [Oras](https://oras.land/docs/) is a CLI tool to push and pull OCI artifacts
+registry Uniform Resource Identifier (URI). [ORAS](https://oras.land/docs/) is a CLI tool to push and pull OCI artifacts
 to and from OCI registries.
 
+:::warning
+
+If you are not using the tutorial container, ensure you have ORAS version `1.0.0` installed. This version is explicitly
+required for pushing packs to OCI registries.
+
+:::
+
 ```bash
 aws ecr get-login-password --region $AWS_DEFAULT_REGION | oras login --username AWS --password-stdin $ACCOUNT_ID.dkr.ecr.$AWS_DEFAULT_REGION.amazonaws.com
 ```
@@ -494,7 +509,15 @@ After creating the projects, proceed with the Harbor authentication. In the tuto
 export HARBOR_ADDRESS=<Your_Harbor_Address>
 ```
 
-Now, issue the command `oras login`.
+Now, issue the command `oras login`. [ORAS](https://oras.land/docs/) is a CLI tool to push and pull OCI artifacts to and
+from OCI registries.
+
+:::warning
+
+If you are not using the tutorial container, ensure you have ORAS version `1.0.0` installed. This version is explicitly
+required for pushing packs to OCI registries.
+
+:::
 
 ```bash
 oras login $HARBOR_ADDRESS
@@ -603,6 +626,13 @@ Harbor repository and push the pack.
 - `NAME` - the pack's name, which must match the name in the **pack.json** file.
 - `VERSION` - the pack's version, which must match the version in the **pack.json** file.
 
+:::warning
+
+Ensure that the variables `NAME` and `VERSION` match the pack name and version in the **pack.json** file. This is a
+requirement for the pack to be correctly pushed to the registry.
+
+:::
+
 ```bash
 export HARBOR_PROJECT=spectro-oci-registry
 export NAME=hellouniverse