Correct grammar and spelling for Mainnet and testnets (staging) (#991)

* add Real World Marlowe to Marlowe page * Correct grammar and spelling for Mainnet and testnets
cardano-foundation · rphair · May 8, 2023 · Aug 3, 2022 · Aug 3, 2022 · Aug 4, 2022
commit d7baea042ba02adc25cc67eb93c31504de02e8d1
diff --git a/docs/get-started/cardano-wallet-js.md b/docs/get-started/cardano-wallet-js.md
@@ -279,7 +279,7 @@ let address = await wallet.getNextAddress();
 let address = await wallet.getAddressAt(45);  
 ``` 
 ### Wallet balances
-When you create a wallet the initial balance is 0. If you are in the mainnet you can transfer Ada to this address. If you are on the testnet you can request test tokens from the [Faucet](https://developers.cardano.org/en/testnets/cardano/tools/faucet/), just input one of the addresses of your wallet and request funds. 
+When you create a wallet the initial balance is 0. If you are in the Mainnet you can transfer Ada to this address. If you are on a testnet you can request test tokens from the [Faucet](https://developers.cardano.org/en/testnets/cardano/tools/faucet/), just input one of the addresses of your wallet and request funds. 
 ```js
 // get available balance. The balance you can expend
 let availableBalance = wallet.getAvailableBalance();

diff --git a/docs/get-started/cardanocli-js.md b/docs/get-started/cardanocli-js.md
@@ -60,7 +60,7 @@ console.log(wallet.paymentAddr);
 console.log(pool.vrf.vkey);
 ```
 
-## For testnet for example this is the working version
+## For testnets for example this is the working version
 
 ```
 const CardanocliJs = require("cardanocli-js");

diff --git a/docs/get-started/cscli.md b/docs/get-started/cscli.md
@@ -29,7 +29,7 @@ Download the platform-specific binaries from the [latest release](https://github
 ```console
 $ cscli --help
 cscli v0.3.0
-A lightweight cross-platform tool for building and serialising Cardano wallet entities (i.e. recovery-phrases, keys, addresses and transactions), querying the chain and submitting transactions to the testnet or mainnet networks. Please refer to https://github.com/CardanoSharp/cscli for further documentation.
+A lightweight cross-platform tool for building and serialising Cardano wallet entities (i.e. recovery-phrases, keys, addresses and transactions), querying the chain and submitting transactions to the testnets or Mainnet. Please refer to https://github.com/CardanoSharp/cscli for further documentation.
 
 USAGE: cscli (OPTION | COMMAND)
 

diff --git a/docs/get-started/dandelion-apis.md b/docs/get-started/dandelion-apis.md
@@ -62,7 +62,7 @@ values={[
   <TabItem value="curl">
 
 ```sh
-# testnet
+# testnets
 curl -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      --data-binary \
@@ -99,9 +99,9 @@ values={[
   <TabItem value="curl">
 
 ```sh
-# testnet
+# testnets
 curl -s https://explorer-api.testnet.dandelion.link/api/txs/last
-# mainnet
+# Mainnet
 curl -s https://explorer-api.mainnet.dandelion.link/api/txs/last
 ```
   </TabItem>

diff --git a/docs/get-started/installing-cardano-node.md b/docs/get-started/installing-cardano-node.md
@@ -31,7 +31,7 @@ To set up the components, you will need:
 * **16GB** of RAM and at least **75GB** of free disk space
 
 :::note
-If intending to connect to mainnet instance, the requirements for RAM and storage would increase beyond baselines above.
+If intending to connect to Mainnet instance, the requirements for RAM and storage would increase beyond baselines above.
 :::
 
 ### Choose your Platform

diff --git a/docs/get-started/installing-cardano-wallet.md b/docs/get-started/installing-cardano-wallet.md
@@ -26,7 +26,7 @@ This guide assumes you have installed `cardano-node` and `cardano-cli` into your
 
 :::important
 
-You must connect your `cardano-node` to the `testnet` network and make sure it is fully synchronized. If you are not sure how to do that, It is recommended to read [Running cardano-node](running-cardano.md) guide before proceeding.
+You must connect your `cardano-node` to a [testnet network](docs/get-started/testnets-and-devnets.md) and make sure it is fully synchronized. If you are not sure how to do that, It is recommended to read [Running cardano-node](running-cardano.md) guide before proceeding.
 
 :::
 

diff --git a/docs/get-started/koios.md b/docs/get-started/koios.md
@@ -6,7 +6,7 @@ description: Get Started with Koios
 image: ../img/og/og-getstarted-koios.png
 ---
 
-Koios provides an open-source & elastic API layer that allows you to query Cardano blockchain (across mainnet, testnet and guildnet network).
+Koios provides an open-source & elastic API layer that allows you to query Cardano blockchain (across Mainnet, testnets and guildnet network).
 The key flexibility from a consumer of Koios API is being able to use Koios as a light webservice or being able to run a Koios instance and optionally `extend` the query layer with automatic failover and high availability support across the globe. When running an instance, one is free to add additional endpoints to their individual service if they have a use case that may not need to be added upstream.
 
 Let's start with basics from consumer point of view, and then we can dive to a brief summary about running a Koios Instance as a provider (independently OR adding to existing members of Koios cluster).
@@ -57,7 +57,7 @@ Typical steps involved for setting up your gRest instance would be (assuming you
 
 4. Once your node is in sync, set up your dbsync instance (easier to use snapshots instead of synching from scratch) as per instructions [here](https://cardano-community.github.io/guild-operators/Build/dbsync/). Ensure that you're running dbsync as a systemd service (not as a script on terminal).
 
-5. You should now be able to run the `setup-grest.sh` script as per details [here](https://cardano-community.github.io/guild-operators/Build/grest/#setup). Thus, if you'd like to deploy gRest against mainnet version, you may elect to run `./setup-grest.sh -f -i prmcd -q -b <branch/tag>` which will set up all the components, endpoints and deploy them as service on your system.
+5. You should now be able to run the `setup-grest.sh` script as per details [here](https://cardano-community.github.io/guild-operators/Build/grest/#setup). Thus, if you'd like to deploy gRest against Mainnet version, you may elect to run `./setup-grest.sh -f -i prmcd -q -b <branch/tag>` which will set up all the components, endpoints and deploy them as service on your system.
 
 6. [Optional] You can also install [ogmios](https://ogmios.dev) instance to have it enabled on your instance. This is currently not enabled by default, as it would require more advanced session management over WSS, that is more suited for a server-client architecture than a RESTful interface to access directly. There may be middleware leveraging this service in future, but it will not be scoped for v1 of Koios API.
 

diff --git a/docs/get-started/running-cardano.md b/docs/get-started/running-cardano.md
@@ -21,12 +21,12 @@ This guide does not cover the topic of running a block-producing `cardano-node`
 ### Testnet
 There are two types of testnet: `preview` and `pre-prod`.
 
-- **Preview Testnet**: Testing release candidates and mainnet releases. Leads mainnet hard forks by at least 4 weeks. This net is for those who just want to see how it runs, get familiarised and play with cardano-node.
+- **Preview Testnet**: Testing release candidates and Mainnet releases. Leads Mainnet hard forks by at least 4 weeks. This net is for those who just want to see how it runs, get familiarised and play with cardano-node.
 
-- **Pre-Production Testnet**: Testing release candidates and mainnet releases. Forks at approximately same time as mainnet (within an epoch of each other). This net is ideal for those who are ready to run the mainnet but want to test it before running it.
+- **Pre-Production Testnet**: Testing release candidates and Mainnet releases. Forks at approximately same time as Mainnet (within an epoch of each other). This net is ideal for those who are ready to run the Mainnet but want to test it before running it.
 
 ### Production (Mainnet)
-This is the live Production. Only gets official mainnet releases. Please use this net once you are ready to use the cardano-node.
+This is the live Production. Only gets official Mainnet releases. Please use this net once you are ready to use the cardano-node.
 
 ### Configuration Files
 
@@ -98,9 +98,9 @@ Each network has a `config` file, `genesis` file(s), `topology` file, and unique
 This section will be updated when new **Cardano** networks come online with their respective configuration files and **Network Magic**.
 :::
 
-You might be asking what the difference is between `mainnet` and `testnet` and why there are two networks? To put it simply, **Cardano** is an open-source blockchain, and anyone is free to spin up a network based on **Cardano's** software components. The `mainnet` network was the first one established during the start of the **Byron** era in 2017.  And everyone participating in the network agreed that is where all the real value of **Cardano** lives.
+You might be asking what the difference is between `mainnet` and `testnet` and why there are two official network types? To put it simply, **Cardano** is an open-source blockchain, and anyone is free to spin up a network based on **Cardano's** software components. The `mainnet` network was the first one established during the start of the **Byron** era in 2017.  And everyone participating in the network agreed that is where all the real value of **Cardano** lives.
 
- Testing the network's features and capabilities can be expensive and will consume real value. So [Input-Output Global](https://iohk.io) has spun up a sandbox or testnet version of the network. Instead of using real `ada` tokens for transactions, you use the `tAda` or **Test ADA**. Alternatively, you can spin up your own custom **Cardano** network, but that is outside the scope of this guide.
+ Testing the network's features and capabilities can be expensive and will consume real value. So [Input-Output Global](https://iohk.io) has spun up sandboxes or testnet versions of the network. Instead of using real `ada` tokens for transactions, you use the `tAda` or **Test ADA**. Alternatively, you can spin up your own custom **Cardano** network, but that is outside the scope of this guide.
 
 ### Running the node
 
@@ -188,7 +188,7 @@ $HOME/cardano/testnet/
 └── topology.json
 1 directory, 4 files
 ```
-> As you may have noticed, we are planning to run a `testnet` node in this example and have downloaded the configuration files into the `$HOME/cardano/testnet/` directory. We also see that we have created the `db` directory inside `$HOME/cardano/testnet/` successfully. The argument would look something like this: 
+> As you may have noticed, we are planning to run a testnet node in this example and have downloaded the configuration files into the `$HOME/cardano/testnet/` directory. We also see that we have created the `db` directory inside `$HOME/cardano/testnet/` successfully. The argument would look something like this: 
 ```
 --database-path $HOME/cardano/testnet/db
 ```
@@ -311,7 +311,7 @@ Finally, we can now test querying the blockchain tip of our `cardano-node`:
 ```
 
 :::note
-We include `--testnet-magic <NetworkMagic>` in the parameter for `cardano-cli query tip` because we are using a `testnet` node. If you intend to query `mainnet` instead, please use the `--mainnet` parameter  and make sure your node is connected to the `mainnet` network.
+We include `--testnet-magic <NetworkMagic>` in the parameter for `cardano-cli query tip` because we are using a testnet node. If you intend to query `mainnet` instead, please use the `--mainnet` parameter  and make sure your node is connected to the `mainnet` network.
 :::
 
 What you see here is the local tip data of your node. This case, means that you are synced up to `block: 2598870` and `slot: 27149964`.

diff --git a/docs/get-started/secure-workflow.md b/docs/get-started/secure-workflow.md
@@ -66,7 +66,7 @@ Format a memory stick on a machine you believe to be secure, and then (to be on
 
 ## Steps of a secure transaction
 
-This is rewritten from page [Create Simple Transaction](../stake-pool-course/handbook/create-simple-transaction) (only considered secure to run on testnet) with the following exception:
+This is rewritten from page [Create Simple Transaction](../stake-pool-course/handbook/create-simple-transaction) (only considered secure to run on a testnet) with the following exception:
 
   - [Determining the TTL (time to Live)](../stake-pool-course/handbook/create-simple-transaction#determine-the-ttl-time-to-live-for-the-transaction) for the transaction is omitted, along with setting this value in the transaction itself, to simplify the information-gathering step.
   - This poses no security risk since an omitted TTL value allows a Tx file to be used indefinitely *but* submitting that Tx will change the UTxO set so that submitting that transaction again will be impossible.

diff --git a/docs/get-started/tangocrypto.md b/docs/get-started/tangocrypto.md
@@ -41,7 +41,7 @@ We provide the most accessible and reliable Cardano infrastructure, freeing comp
 
 ### Network and App ID
 
-You can choose the mainnet or the testnet for your queries. The API requires a valid `app_id` to be included with your request traffic. This identifier should be appended to the request URL.
+You can choose Mainnet or a testnet for your queries. The API requires a valid `app_id` to be included with your request traffic. This identifier should be appended to the request URL.
 
 | Network          |   Endpoint      
 | ---------------- | :-----------: 

diff --git a/docs/integrate-cardano/creating-wallet-faucet.md b/docs/integrate-cardano/creating-wallet-faucet.md
@@ -8,12 +8,12 @@ image: ../img/og/og-developer-portal.png
 
 ### Overview 
 
-In this guide, we will show you how to create a **Cardano** wallet, receive some `tAda` (**test ada**) in the `testnet` network and send basic example transactions. We will explore tools like `cardano-cli` and `cardano-wallet` on how they can help with these functionalities.
+In this guide, we will show you how to create a **Cardano** wallet, receive some `tAda` (**test ada**) on a [testnet network](docs/get-started/testnets-and-devnets.md) and send basic example transactions. We will explore tools like `cardano-cli` and `cardano-wallet` on how they can help with these functionalities.
 
 :::note
 This guide assumes you have installed `cardano-node` and `cardano-cli` into your system. If not you can refer to [Installing cardano-node](/docs/get-started/installing-cardano-node) guide for instructions on how to do that.
 
-You must also connect your `cardano-node` to the `testnet` network and make sure it is fully synchronized.
+You must also connect your `cardano-node` to a testnet network and make sure it is fully synchronized.
 
 If you are not sure how to do that, It is recommended to read [Running cardano-node](/docs/get-started/running-cardano) guide before proceeding.
 :::
@@ -62,7 +62,7 @@ In this section, We will use the path `$HOME/cardano` to store all the `cardano-
 :::
 
 :::important
-Please make sure your `cardano-node` is connected and synchronized to the `testnet` network before proceeding.
+Please make sure your `cardano-node` is connected and synchronized to a testnet network before proceeding.
 :::
 
 :::warning
@@ -125,7 +125,7 @@ Lets try to understand what these keys are used for in a very high-level overvie
     }
     ```
 
-Since we now have our **payment key-pair**, the next step would be to generate a **wallet address** for the `testnet` network like so:
+Since we now have our **payment key-pair**, the next step would be to generate a **wallet address** for a testnet network like so:
 
 ```bash
 cardano-cli address build \
@@ -162,8 +162,8 @@ addr_test1vz95zjvtwm9u9mc83uzsfj55tzwf99fgeyt3gmwm9gdw2xgwrvsa5
 :::note
  You can derive more than one **wallet address** from a **Public Verification Key** for more advanced use-cases using `cardano-addresses` component. Which we discuss in more details here: ***@TODO: link to article***
 
-  - `mainnet` addresses are **prefixed** with the string value `addr1`. 
-  - `testnet` addresses are **prefixed** with the string value `addr_test1`. 
+  - Mainnet addresses are **prefixed** with the string value `addr1`. 
+  - testnet addresses are **prefixed** with the string value `addr_test1`. 
 
 
  If you want to create a wallet address to be used on `mainnet`, please use the `--mainnet` flag instead of `--testnet-magic 1097911063`. You can learn more about the different **Cardano** blockchain networks [here](/docs/get-started/running-cardano#mainnet--production).
@@ -181,7 +181,7 @@ cardano-cli query utxo \
 
 - `cardano-cli query utxo` : Queries the wallet address **UTXO**.
 
-- `--testnet-magic 1097911063` : Specifies that we want to query the `testnet` **Cardano** network.
+- `--testnet-magic 1097911063` : Specifies that we want to query a testnet **Cardano** network.
 
 - `--address $(cat $HOME/cardano/keys/payment1.addr)` : The **wallet address** string value that we want to query, In this case we read the contents of `$HOME/cardano/keys/payment1.addr` using the `cat` command and we pass that value to the `--address` flag. That means you could also directly paste the **wallet address** value like so: 
 ```
@@ -485,7 +485,7 @@ We will use the path `$HOME/cardano/wallets` to store all the `cardano-wallet` r
 :::
 
 :::important
-Please make sure your `cardano-node` is connected and synchronized to the `testnet` network before proceeding.
+Please make sure your `cardano-node` is connected and synchronized to a testnet network before proceeding.
 :::
 
 :::warning
@@ -516,7 +516,7 @@ cardano-wallet serve \
 
 > You can choose whatever `port` number you like, but it is recommended to use `port` numbers `1024` and above. See [Registered Port](https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml) for more information.
 
-`--testnet` : Specifies the **Byron** genesis file path for the `testnet` network.
+`--testnet` : Specifies the **Byron** genesis file path for the testnet network.
 
 > This should match the genesis file that the `cardano-node` you are connected is using as-well. If you meant to connect to `mainnet` then use the `--mainnet` flag and the `mainnet` **Byron** genesis file instead.
-Original file line number
+Diff line change
@@ Expand Up @@
     :::important
-    You must connect your `cardano-node` to the `testnet` network and make sure it is fully synchronized. If you are not sure how to do that, It is recommended to read [Running cardano-node](running-cardano.md) guide before proceeding.
+    You must connect your `cardano-node` to a [testnet network](docs/get-started/testnets-and-devnets.md) and make sure it is fully synchronized. If you are not sure how to do that, It is recommended to read [Running cardano-node](running-cardano.md) guide before proceeding.
     :::
@@ Expand Down @@