Merge pull request #122 from formancehq/numscript-experimental-updates

Added content for new numscript interpreter

Author: Amruta-Ranade

docs/numscript/embedding.mdx

@@ -1,9 +1,11 @@
 ---
-title: Embedding
+title: Selecting an interpreter
 ---
 
-Historically, Numscript was being built in a tightly knit way to our Ledger service, an extensible system-of-record and querying layer for financial transactions.
+Since Ledger v2.2, two versions of the Numscript interpreter are available: the original, built directly into our Ledger service, and a new portable and embeddable interpreter that can run independently or enhance other ledgering systems.
 
-The new revision of Numscript is this time designed with portability and embeddability in mind. While Numscript is natively embedded in our Ledger service, you can also now run Numscript separately or bolt it on top of your existing ledgering system as a way to improve its programmability.
+The original interpreter is enabled by default but is no longer evolving, while the new version will receive ongoing updates and must be manually enabled.
 
-The standalone Numscript codebase can be found [here](https://github.com/formancehq/numscript).
+To enable the new interpreter, enable the `ledger.experimental-features` and `ledger.experimental-numscript` [settings](../operator/Configuration%20reference/Settings).
+
+Note that the [Numscript playground](https://playground.numscript.org/?template=simple-send) uses the new interpreter, so results there may differ from those in production.

sidebars.ts

@@ -210,6 +210,7 @@ const sidebars = {
             {
               type: 'doc',
               id: 'numscript/embedding',
+              label: "Selecting an interpreter",
             },
             {
               type: 'category',

versioned_docs/version-v2.x/numscript/embedding.mdx

@@ -1,9 +1,11 @@
 ---
-title: Embedding
+title: Selecting an interpreter
 ---
 
-Historically, Numscript was being built in a tightly knit way to our Ledger service, an extensible system-of-record and querying layer for financial transactions.
+Since Ledger v2.2, two versions of the Numscript interpreter are available: the original, built directly into our Ledger service, and a new portable and embeddable interpreter that can run independently or enhance other ledgering systems.
 
-The new revision of Numscript is this time designed with portability and embeddability in mind. While Numscript is natively embedded in our Ledger service, you can also now run Numscript separately or bolt it on top of your existing ledgering system as a way to improve its programmability.
+The original interpreter is enabled by default but is no longer evolving, while the new version will receive ongoing updates and must be manually enabled.
 
-The standalone Numscript codebase can be found [here](https://github.com/formancehq/numscript).
+To enable the new interpreter, enable the `ledger.experimental-features` and `ledger.experimental-numscript` [settings](../operator/Configuration%20reference/Settings).
+
+Note that the [Numscript playground](https://playground.numscript.org/?template=simple-send) uses the new interpreter, so results there may differ from those in production.