Updating for VSEs, updating download details (#1)

paulswithers · GitHub Enterprise · commit 39c8635482fb · 2025-09-24T17:32:21.000+01:00
diff --git a/docs/howto/archipelago/atlas.md b/docs/howto/archipelago/atlas.md
@@ -30,18 +30,7 @@ The `atlas.json` file is used to define a project's metadata as well as dependen
 
 ## VSE Extensions
 
-In EA1 and EA2, it was only possible to download VSEs by using the numeric portions of the file download URL, e.g. **library** as "25265" and **module** as "25877/20841". The module changed for each version, because it corresponded to a specific file download. This required the Volt MX Marketplace repository URL to be **"https://community.demo-hclvoltmx.com/marketplace/asset"**.
-
-From EA3, a different download URL from Volt MX Marketplace is supported. For this, the **library** is the asset title, e.g. "JsonVSE VoltScript Extension". The **module** is the asset filename when downloaded, minus the file suffix, e.g. "jsonvse". This requires the Volt MX Marketplace repository URL to be **"https://community.demo-hclvoltmx.com/marketplace"**. Note that unlike EA1 and EA2, this does not have "/asset" on the end.
-
-If the VSE library and extension are numeric, you **must** have the repository URL as "https://community.demo-hclvoltmx.com/marketplace/asset". If it is the more human-readable format mapping to the VSE name, you **must** have the repository URL as "https://community.demo-hclvoltmx.com/marketplace". This format is the preferable option and there has been limited usage of EA1 and EA2, so the repository ID has not been changed. Documentation and the latest versions of all VoltScript Library Modules have been updated to use it.
-
-!!! warning
-    All affected VoltScript Library Modules have had new releases. These are:<br/>
-        - VoltScript JSON Converter, version 1.0.4.<br/>
-        - VoltScript Collections, version 1.0.4.<br/>
-        - VoltScript VoltMX Middleware, version 1.0.4.<br/>
-    Ensure you are using at least these versions, or there may be errors downloading downstream dependencies from "https://community.demo-hclvoltmx.com/marketplace".
+The **library** is the asset title, e.g. "JsonVSE VoltScript Extension". The **module** is the asset filename when downloaded, minus the file suffix, e.g. "jsonvse". The Volt MX Marketplace repository URL is **"https://community.demo-hclvoltmx.com/marketplace"**.
 
 !!! info
     By default, VSE files for all platforms (Windows, Linux, MacOS) will be copied into the project. You can use `runtimePlatforms` property to restrict which platforms' VSEs are copied in. For more details, see [How to Structure an atlas.json](../../references/atlas.md).
diff --git a/docs/howto/extensions/buildingjson.md b/docs/howto/extensions/buildingjson.md
@@ -13,7 +13,7 @@ Incorporating JsonVSE is straightforward. You just need to add the following JSO
 ```json
 "JsonVSE": {
     "library": "JsonVSE VoltScript Extension",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "module": "jsonvse",
     "repository":"volt-mx-marketplace"
 }
diff --git a/docs/howto/extensions/encrypt.md b/docs/howto/extensions/encrypt.md
@@ -13,7 +13,7 @@ Incorporating HashVSE is straightforward. You just need to add the following JSO
 ```json
         "HashVSE": {
             "library": "HashVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "hashvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/env-vars.md b/docs/howto/extensions/env-vars.md
@@ -37,7 +37,7 @@ Incorporating OSUtilsVSE is straightforward. You just need to add the following
 ```json
         "OSUtilsVSE": {
             "library": "OSUtilsVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "osutilsvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/file-download.md b/docs/howto/extensions/file-download.md
@@ -16,7 +16,7 @@ Incorporating JsonVSE and WebVSE is straightforward. You just need to add the fo
 ```json
         "WebVSE": {
             "library": "WebVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "webvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/find-files.md b/docs/howto/extensions/find-files.md
@@ -13,7 +13,7 @@ Incorporating OSUtilsVSE is straightforward. You just need to add the following
 ```json
         "OSUtilsVSE": {
             "library": "OSUtilsVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "osutilsvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/hash.md b/docs/howto/extensions/hash.md
@@ -13,7 +13,7 @@ Incorporating HashVSE is straightforward. You just need to add the following JSO
 ```json
         "HashVSE": {
             "library": "hashVSE Voltscript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "hashvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/input.md b/docs/howto/extensions/input.md
@@ -13,13 +13,13 @@ Incorporating StreamVSE and ContextVSE is straightforward. You just need to add
 ```json
         "StreamVSE": {
             "library": "StreamVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "streamvse",
             "repository": "volt-mx-marketplace"
         },
         "ContextVSE": {
             "library": "ContextVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "contextvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/json.md b/docs/howto/extensions/json.md
@@ -13,7 +13,7 @@ Incorporating JsonVSE is straightforward. You just need to add the following JSO
 ```json
         "JsonVSE": {
             "library": "JsonVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "jsonvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/memory-stream.md b/docs/howto/extensions/memory-stream.md
@@ -1,7 +1,28 @@
 # In-memory streaming
 
+--8<-- "setup.md"
+
+## Introduction
+
 Reading and writing to files is useful. But in-memory processing is typically quicker because it removes the disk I/O interaction. In-memory streams are designed as a more performant approach than string concatenation.
 
+## VoltScript dependencies
+
+Incorporating StreamVSE and ContextVSE is straightforward. You just need to add the following JSON object to the `vsesDependencies` element in your `atlas.json`.
+
+```json
+        "StreamVSE": {
+            "library": "StreamVSE VoltScript Extension",
+            "version": "1.0.4",
+            "module": "streamvse",
+            "repository": "volt-mx-marketplace"
+        }
+```
+
+--8<-- "vse-repository.md"
+
+## Processing streams in memory
+
 To create an in-memory stream, open the stream with either "MEMORY" or "BUFFER" as the character set.
 
 ``` voltscript
diff --git a/docs/howto/extensions/read-files.md b/docs/howto/extensions/read-files.md
@@ -13,7 +13,7 @@ Incorporating OSUtilsVSE is straightforward. You just need to add the following
 ```json
         "StreamVSE": {
             "library": "StreamVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "streamvse",
             "repository": "volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/web.md b/docs/howto/extensions/web.md
@@ -16,13 +16,13 @@ Incorporating WebVSE and JsonVSE is straightforward. You just need to add the fo
 ```json
         "WebVSE": {
             "library": "WebVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "webvse",
             "repository":"volt-mx-marketplace"
         },
         "JsonVSE": {
             "library": "JsonVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "jsonvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/xmlbuilding.md b/docs/howto/extensions/xmlbuilding.md
@@ -13,7 +13,7 @@ Incorporating XMLVSE is straightforward. You just need to add the following JSON
 ```json
         "XmlVSE": {
             "library": "XMLVSE VoltScript Extension",
-            "version": "1.0.2",
+            "version": "1.0.3",
             "module": "xmlvse",
             "repository": "volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/xmlparsing.md b/docs/howto/extensions/xmlparsing.md
@@ -14,7 +14,7 @@ Incorporating XMLVSE is straightforward. You just need to add the following JSON
 ```json
         "XmlVSE": {
             "library": "XMLVSE VoltScript Extension",
-            "version": "1.0.2",
+            "version": "1.0.3",
             "module": "xmlvse",
             "repository": "volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/zip.md b/docs/howto/extensions/zip.md
@@ -16,7 +16,7 @@ Incorporating ZipVSE is straightforward. You just need to add the following JSON
 ```json
         "ZipVSE": {
             "library": "ZipVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "zipvse",
             "repository":"volt-mx-marketplace"
         }
diff --git a/docs/howto/extensions/zulu.md b/docs/howto/extensions/zulu.md
@@ -15,7 +15,7 @@ Incorporating ZuluVSE is straightforward. You just need to add the following JSO
 ```json
     "ZuluVSE": {
         "library": "ZuluVSE VoltScript Extension",
-        "version": "1.0.3",
+        "version": "1.0.4",
         "module": "zuluvse",
     }
 ```
diff --git a/docs/references/components.md b/docs/references/components.md
@@ -8,32 +8,30 @@ VoltScript comprises multiple components delivered via different methods. This c
 
 | Location                   | Artefact      | Purpose        |
 |----------------------------|---------------|----------|
-| [My HCLSoftware](https://my.hcltechsw.com/){: target="_blank" rel="noopener noreferrer"} | Windows zip   | Develop VoltScript on Windows<br/>Run standalone VoltScript code on Windows |
-| Harbor                     | Linux Container Image | Develop VoltScript on <br/>Intel Mac / Linux |
-| Harbor                     | Volt Foundry Container Image | <!--**New for EA3-->Upload or code VoltScript<br/>integration services on Volt Foundry |
+| [My HCLSoftware](https://my.hcltechsw.com/){: target="_blank" rel="noopener noreferrer"} | Windows installer  | Develop VoltScript on Windows<br/>Run standalone VoltScript code on Windows |
+| [My HCLSoftware](https://my.hcltechsw.com/){: target="_blank" rel="noopener noreferrer"} | Mac installer  | Develop VoltScript on any Mac<br/>Run standalone VoltScript code on Intel/ARM Mac |
+| Harbor                     | Linux Container Image | Develop VoltScript on <br/>any platform using VS Code Dev Containers |
+| Harbor                     | Volt Foundry Container Image | Upload or code VoltScript<br/>integration services on Volt Foundry |
 | Volt MX Marketplace        | VoltScript Extensions | Provides closed-source low-level functionality<br/>Add via build management<br/>Import into VoltScript integration service zip |
 | HCL GitHub org             | VoltScript Library Modules | Provides open source helpers<br/>Add via build management<br/>Download from Releases and upload to VoltScript integration service zip |
 
+For Volt Foundry, see the Volt Foundry documentation, paying special notice to the [Enable VoltScript in Volt Foundry](https://opensource.hcltechsw.com/voltmxgo-documentation/howto/install/voltscript.html){: target="_blank" rel="noopener noreferrer"} how-to guide in the Volt MX Go documentation.
+
 ## Audience
 
 ### Administrators
 
-Administrators will only require the Volt Foundry container image. This is an early access version of Volt Foundry that includes VoltScript integration services.
-
-!!! warning
-    The Volt Foundry container image should only be used for evaluation of VoltScript integration services. It may include in-development work on other aspects of Volt MX Go. **Support is via Volt MX Early Access Forum and will only be provided on VoltScript integration services.**
-
-!!! note
-    As with Volt MX Go early access program, only a containerized image of Volt Foundry is provided.
+Administrators will only require Volt Foundry. For more information, see the [Enable VoltScript in Volt Foundry](https://opensource.hcltechsw.com/voltmxgo-documentation/howto/install/voltscript.html){: target="_blank" rel="noopener noreferrer"} how-to guide in the Volt MX Go documentation.
 
 ### Developers
 
 Developers' starting point will depend on their development approach:
 
 - For developers wishing to develop VoltScript code locally:
-    - On Windows, download the Windows zip and follow instructions in the [relevant tutorial](../tutorials/ide/windows.md).
-    - On Intel Mac, download the Linux container image and follow instructions in the [relevant tutorial](../tutorials/ide/devcontainer.md).
-- For developers wishing to write their code directly into a Volt Foundry, download the Volt Foundry container image and follow instructions in the [relevant tutorial](../tutorials/foundryinstall/index.md).
+    - On Windows, download the Windows installer and follow instructions in the [relevant tutorial](../tutorials/ide/windows.md).
+    - On any Mac, download the Mac installer and follow instructions in the [relevant tutorial](../tutorials/ide/mac.md).
+    - On any platform, download the Linux dev container image and follow instructions in the [relevant tutorial](../tutorials/ide/devcontainer.md).
+- For developers wishing to write their code directly into a Volt Foundry, see the [Enable VoltScript in Volt Foundry](https://opensource.hcltechsw.com/voltmxgo-documentation/howto/install/voltscript.html){: target="_blank" rel="noopener noreferrer"} how-to guide in the Volt MX Go documentation.
 
 !!! note
     - VoltScript integration service projects can be coded locally and uploaded into Volt Foundry, or they can be coded directly into Volt Foundry. Better IDE integration is currently possible with local development on Visual Studio Code, plus the ability to write and run unit tests. If you know the APIs and are willing to accept that compile-time errors are only exposed at runtime, developing directly on Volt Foundry may be quicker.
diff --git a/docs/references/vses.md b/docs/references/vses.md
@@ -55,7 +55,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "ContextVSE": {
             "library": "ContextVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "contextvse",
             "repository": "volt-mx-marketplace"
         }
@@ -82,7 +82,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "HashVSE": {
             "library": "HashVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "hashvse",
             "repository": "volt-mx-marketplace"
         }
@@ -91,7 +91,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "JsonVSE": {
             "library": "JsonVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "jsonvse",
             "repository": "volt-mx-marketplace"
         }
@@ -100,7 +100,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "OSUtilsVSE": {
             "library": "OSUtilsVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "osutilsvse",
             "repository": "volt-mx-marketplace"
         }
@@ -109,7 +109,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "StreamVSE": {
             "library": "StreamVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "streamvse",
             "repository": "volt-mx-marketplace"
         }
@@ -118,7 +118,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "WebVSE": {
             "library": "WebVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "webvse",
             "repository": "volt-mx-marketplace"
         }
@@ -127,7 +127,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "XmlVSE": {
             "library": "XMLVSE VoltScript Extension",
-            "version": "1.0.2",
+            "version": "1.0.3",
             "module": "xmlvse",
             "repository": "volt-mx-marketplace"
         }
@@ -136,7 +136,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "ZipVSE": {
             "library": "ZipVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "zipvse",
             "repository": "volt-mx-marketplace"
         }
@@ -145,7 +145,7 @@ You'll need the relevant dependency to add to your **vseDependencies** object in
 ```json
         "ZuluVSE": {
             "library": "ZuluVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "zuluvse",
             "repository": "volt-mx-marketplace"
         }
diff --git a/docs/tutorials/ide/devcontainer.md b/docs/tutorials/ide/devcontainer.md
@@ -43,14 +43,14 @@ You will need to load the docker image for VoltScript downloaded from [Harbor](h
 1. Type `docker login https://hclcr.io` and press enter.
 1. Enter the email address from your user profile as the username.
 1. Paste the CLI secret as the password.
-1. Once login is successful, enter the command `docker pull hclcr.io/voltmxgo-ea/voltscript-devcontainer:1.0.3` and press enter.
+1. Once login is successful, enter the command `docker pull hclcr.io/voltmxgo/voltscript-devcontainer:10.0.0_GA` and press enter.
 
     !!! warning
         Do not click the copy icon in the "Pull Command" column on the **voltscript-devcontainer** project page. This uses the SHA hash instead, so the Docker image will come down untagged.
 
         ![Copy](../../assets/images/harbor_devcontainer.png)
 
-1. The image should now be available. You can confirm by issuing the command `docker images`, where you should find an image named "hclcr.io/voltmxgo-ea/voltscript-devcontainer" with a tag 1.0.3.
+1. The image should now be available. You can confirm by issuing the command `docker images`, where you should find an image named "hclcr.io/voltmxgo/voltscript-devcontainer" with a tag 10.0.0_GA.
 
 ## Creating the Dev Container
 
@@ -66,7 +66,7 @@ At the minimum, the JSON file must have the following content:
 
 ```json
 {
-    "image": "hclcr.io/voltmxgo-ea/voltscript-devcontainer:1.0.3",
+    "image": "hclcr.io/voltmxgo/voltscript-devcontainer:10.0.0_GA",
     // Configure tool-specific properties.
     "customizations": {
         // Configure properties specific to VS Code.
diff --git a/docs/tutorials/walkthrough/lab-03a.md b/docs/tutorials/walkthrough/lab-03a.md
@@ -53,7 +53,7 @@ You'll learn how to use dependency management, how it creates a `seti.ini`, and
 1. Add vseDependencies object. This is an object, because each element needs a label that will be used in the `UseVSE` statement.
 1. Add a label "StreamVSE". For the value, then add an empty JSON object.
     1. Set library to "StreamVSE VoltScript Extension".
-    1. Set version to "1.0.3".
+    1. Set version to "1.0.4".
     1. Set module to "streamvse".
     1. Set repository to "volt-mx-marketplace".
 1. **Save** the atlas.json. The final atlas.json should look like this:
@@ -100,7 +100,7 @@ You'll learn how to use dependency management, how it creates a `seti.ini`, and
     "vseDependencies": {
         "StreamVSE": {
             "library": "StreamVSE VoltScript Extension",
-            "version": "1.0.3",
+            "version": "1.0.4",
             "module": "streamvse",
             "repository": "volt-mx-marketplace"
         }

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ Incorporating JsonVSE is straightforward. You just need to add the following JSO`
`13`	`13`	```json
`14`	`14`	`"JsonVSE": {`
`15`	`15`	`"library": "JsonVSE VoltScript Extension",`
`16`		`- "version": "1.0.3",`
	`16`	`+ "version": "1.0.4",`
`17`	`17`	`"module": "jsonvse",`
`18`	`18`	`"repository":"volt-mx-marketplace"`
`19`	`19`	`}`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ Incorporating HashVSE is straightforward. You just need to add the following JSO`
`13`	`13`	```json
`14`	`14`	`"HashVSE": {`
`15`	`15`	`"library": "HashVSE VoltScript Extension",`
`16`		`- "version": "1.0.3",`
	`16`	`+ "version": "1.0.4",`
`17`	`17`	`"module": "hashvse",`
`18`	`18`	`"repository":"volt-mx-marketplace"`
`19`	`19`	`}`
Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@ Incorporating OSUtilsVSE is straightforward. You just need to add the following`
`37`	`37`	```json
`38`	`38`	`"OSUtilsVSE": {`
`39`	`39`	`"library": "OSUtilsVSE VoltScript Extension",`
`40`		`- "version": "1.0.3",`
	`40`	`+ "version": "1.0.4",`
`41`	`41`	`"module": "osutilsvse",`
`42`	`42`	`"repository":"volt-mx-marketplace"`
`43`	`43`	`}`
Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,7 @@ Incorporating JsonVSE and WebVSE is straightforward. You just need to add the fo`
`16`	`16`	```json
`17`	`17`	`"WebVSE": {`
`18`	`18`	`"library": "WebVSE VoltScript Extension",`
`19`		`- "version": "1.0.3",`
	`19`	`+ "version": "1.0.4",`
`20`	`20`	`"module": "webvse",`
`21`	`21`	`"repository":"volt-mx-marketplace"`
`22`	`22`	`}`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ Incorporating OSUtilsVSE is straightforward. You just need to add the following`
`13`	`13`	```json
`14`	`14`	`"OSUtilsVSE": {`
`15`	`15`	`"library": "OSUtilsVSE VoltScript Extension",`
`16`		`- "version": "1.0.3",`
	`16`	`+ "version": "1.0.4",`
`17`	`17`	`"module": "osutilsvse",`
`18`	`18`	`"repository":"volt-mx-marketplace"`
`19`	`19`	`}`