copy & image updates

content/concepts/ocean-tokens.md

@@ -15,28 +15,6 @@ description: The technical basics of Ocean Tokens.
 | Token Symbol           | OCEAN                                                    |
 | Decimals of Precision  | 18                                                       |
 
-## Testnet Ocean Tokens
-
-There are Ocean Tokens in several testnets, including the Nile testnet. They are just testnet Ocean Tokens (i.e. for testing purposes only) and they aren't interchangeable with Ethereum Mainnet Ocean Tokens. For more details, see the the [page about Testnets](/concepts/testnets/) and the [tutorials](/tutorials/introduction/).
-
-### Testnet Ocean Token Utility
-
-Once you have some Testnet Ocean Tokens, you can use them for all currently-implemented Ocean Protocol tasks _in that testnet_ (e.g. buying assets).
-
-### Get Testnet Ocean Tokens
-
-All Squid libraries have methods to request Ocean Tokens. They work by calling the "Dispenser" keeper contract, a contract which is only deployed to testnets. Therefore they will only work in testnets. They're documented in the following places:
-
-- The squid-js docs for:
-  - [OceanAccounts.requestTokens()](/references/squid-js/#OceanAccounts-requestTokens)
-  - [Account.requestTokens()](/references/squid-js/#Account-requestTokens)
-- The squid-py docs for:
-  - [the `squid_py.ocean.ocean_tokens` module](https://squid-py.readthedocs.io/en/develop/api/squid_py.ocean.ocean_tokens.html): see the `request()` method.
-  - [the `squid_py.ocean.ocean_accounts` module](https://squid-py.readthedocs.io/en/develop/api/squid_py.ocean.ocean_accounts.html): see the `request_tokens()` method.
-- [The squid-java docs](https://www.javadoc.io/doc/com.oceanprotocol/squid/): click "All Classes" then "AccountsManager" then scroll to the bottom of the Class AccountsManager page where you'll find the `requestTokens()` method.
-
-The [Example Code page](/tutorials/example-code/) has links to example Squid code (in all of the languages), including examples of using the above methods.
-
 ## Ethereum Mainnet Ocean Tokens
 
 There were several ways to acquire some of the Ethereum Mainnet Ocean Tokens in the initial circulating supply, including:
@@ -48,8 +26,8 @@ There were several ways to acquire some of the Ethereum Mainnet Ocean Tokens in
 - completion of a [bounty](/concepts/bounties/)
 
 After [the initial exchange offering on Bittrex International](https://blog.oceanprotocol.com/initial-exchange-offering-of-ocean-protocol-on-bittrex-international-a454688f466a), Ethereum Mainnet Ocean Tokens became available in the Ethereum Mainnet (and not in any other network).
-The initial circulating supply of Ethereum Mainnet Ocean Tokens became available on the Ethereum Mainnet in May 2019.
-If you acquired Ocean Tokens in the initial circulating supply, they should have been, or will be, sent to the address you provided, in the Ethereum Mainnet.
+
+The initial circulating supply of Ethereum Mainnet Ocean Tokens became available on the Ethereum Mainnet in May 2019. If you acquired Ocean Tokens in the initial circulating supply, they should have been, or will be, sent to the address you provided, in the Ethereum Mainnet.
 
 ### How to Check Your Ethereum Mainnet Ocean Token Balance
 
@@ -83,11 +61,40 @@ Below is the _official list_ of exchanges which listed Ethereum Mainnet Ocean To
 
 ## Pacific Network Ocean Tokens
 
-At the time of writing, the [Pacific Network](/concepts/pacific-network/) wasn't publicly-usable yet. Once it is, there will be a token bridge from the Ethereum Mainnet to the Pacific Network, allowing you to move Ocean Tokens from the Ethereum Mainnet to the Pacific Network.
+Ocean Tokens in Ocean's Mainnet, [Pacific](/concepts/pacific-network/), represent the same value as they have in the Ethereum Mainnet. The only way to get Ocean Tokens in Pacific is to transfer them from the Ethereum Mainnet.
+
+For this purpose there is a token bridge, allowing you to move Ocean Tokens from the Ethereum Mainnet to the Pacific Network:
+
+- [**Ocean Token Bridge**](https://bridge.oceanprotocol.com)
+- [Tutorial: Transfer Ocean Tokens between Networks](/tutorials/token-bridge/)
+
+## Testnet Ocean Tokens
+
+There are Ocean Tokens in several testnets, including the Nile testnet. They are just testnet Ocean Tokens (i.e. for testing purposes only) and they aren't interchangeable with Ethereum Mainnet Ocean Tokens. For more details, see the the [page about Testnets](/concepts/testnets/) and the [tutorials](/tutorials/introduction/).
+
+### Testnet Ocean Token Utility
+
+Once you have some Testnet Ocean Tokens, you can use them for all currently-implemented Ocean Protocol tasks _in that testnet_ (e.g. buying assets).
+
+### Get Testnet Ocean Tokens
+
+All Squid libraries have methods to request Ocean Tokens. They work by calling the _Dispenser_ keeper contract, a contract which is only deployed to testnets. Therefore they will only work in testnets.
+
+They're documented in the following places:
+
+- The squid-js docs for:
+  - [`OceanAccounts.requestTokens()`](/references/squid-js/#OceanAccounts-requestTokens)
+  - [`Account.requestTokens()`](/references/squid-js/#Account-requestTokens)
+- The squid-py docs for:
+  - [the `squid_py.ocean.ocean_tokens` module](https://squid-py.readthedocs.io/en/develop/api/squid_py.ocean.ocean_tokens.html): see the `request()` method.
+  - [the `squid_py.ocean.ocean_accounts` module](https://squid-py.readthedocs.io/en/develop/api/squid_py.ocean.ocean_accounts.html): see the `request_tokens()` method.
+- [The squid-java docs](https://www.javadoc.io/doc/com.oceanprotocol/squid/): click _All Classes_ then _AccountsManager_ then scroll to the bottom of the Class _AccountsManager_ page where you'll find the `requestTokens()` method.
+
+The [Example Code page](/tutorials/example-code/) has links to example Squid code (in all of the languages), including examples of using the above methods.
 
 ## Further Reading about Ocean Tokens
 
 - [Teach Your Wallet to Track Ocean Tokens](/tutorials/wallets-and-ocean-tokens/)
-- “[Ocean Tokenomics](https://blog.oceanprotocol.com/ocean-tokenomics-d34f28c480a8)”
-- “[Ocean Tokenomics II](https://blog.oceanprotocol.com/https-blog-oceanprotocol-com-ocean-tokenomics-ii-faf05854314b)”
+- [Ocean Tokenomics](https://blog.oceanprotocol.com/ocean-tokenomics-d34f28c480a8)
+- [Ocean Tokenomics II](https://blog.oceanprotocol.com/https-blog-oceanprotocol-com-ocean-tokenomics-ii-faf05854314b)
 - [Ocean Protocol Technical Whitepaper](https://oceanprotocol.com/tech-whitepaper.pdf)

content/concepts/pacific-network.md

@@ -14,10 +14,18 @@ Over time, the Pacific Network will be upgraded and improved.
 There is no intent to shut it down.
 Eventually, the goal is for it to be used in production by many projects.
 
-[Ocean Tokens](/concepts/ocean-tokens/) can, in principle, live in any EVM-compatible network. The ones sold in the Ocean Protocol token sale were in the Ethereum Mainnet. There is a token bridge between the Ethereum Mainnet and the Pacific Network, allowing anyone with Ocean Tokens to move them from the Ethereum Mainnet to the Pacific Network. However, please be aware that doing so would put those Ocean Tokens at risk. For more information, see [the page about Ocean Tokens](/concepts/ocean-tokens/).
-
 [^1]: The Pacific Network is (or was) also known by other names, including _Pacific_, _Main Ocean Network_, _Ocean Mainnet_, _Ocean Live Network_.
 
+## Ocean Tokens in Pacific
+
+[Ocean Tokens](/concepts/ocean-tokens/) can, in principle, live in any EVM-compatible network. The ones sold in the Ocean Protocol token sale were in the Ethereum Mainnet. To be able to use them in Pacific, they need to be transfered with a token bridge.
+
+There is a token bridge between the Ethereum Mainnet and the Pacific Network, allowing anyone with Ocean Tokens to move them from the Ethereum Mainnet to the Pacific Network.
+
+[**Ocean Token Bridge**](https://bridge.oceanprotocol.com)
+
+However, please be aware that doing so would put those Ocean Tokens at risk. For more information, see [the page about Ocean Tokens](/concepts/ocean-tokens/).
+
 ## Connect to the Pacific Network
 
 See the tutorial page about [connecting to Ocean-related networks](/tutorials/connect-to-networks/#connect-to-the-pacific-network) to connect to Pacific in your browser with MetaMask.

content/tutorials/get-ether-and-ocean-tokens.md

@@ -3,9 +3,9 @@ title: Get Ether and Ocean Tokens
 description: A tutorial about how to get Ether and Ocean Tokens.
 ---
 
-If you want to interact with an Ethereum-based network that supports Ocean Protocol, then you'll eventually need Ether or [Ocean Tokens](/concepts/ocean-tokens/) _for that network_. (Every Ethereum-based network has its own Ether and maybe its own Ocean Tokens, and you can't use those in other networks.)
+If you want to interact with an Ethereum-based network that supports Ocean Protocol, then you'll eventually need Ether or [Ocean Tokens](/concepts/ocean-tokens/) _for that network_. Every Ethereum-based network has its own Ether and its own Ocean Tokens, and you can't use those in other networks.
 
-At the time of writing, there were some public testnets you could use to test an Ocean Protocol application. For more information about those, see the page about [testnets](/concepts/testnets/).
+There are some public testnets you can use to test an Ocean Protocol application. For more information about those, see the page about [testnets](/concepts/testnets/).
 
 ## Get a Compatible Wallet
 

content/tutorials/token-bridge.md

@@ -1,32 +1,39 @@
 ---
 title: Transfer Ocean Tokens between Networks
-description: How to use the token bridge to transfer Ocean Tokens from the Ethereum Mainnet to the Pacific Network.
+description: How to use the token bridge to transfer Ocean Tokens from the Ethereum Mainnet to the Pacific Network, and vice versa.
 ---
 
 TODO: All images here are placeholders for now. Replace them with images showing the Ocean-specific token bridge UI.
 
 ## Introduction
 
-There is a token bridge between the Ethereum Mainnet and [the Pacific Network](/concepts/pacific-network/). It's based on [the TokenBridge by POA Network](https://medium.com/poa-network/introducing-the-erc20-to-erc20-tokenbridge-ce266cc1a2d0) (the company), but the user interface was modified to conform to the Ocean Protocol style.[^1]
+There is a token bridge between the Ethereum Mainnet and the [Pacific Network](/concepts/pacific-network/):
+
+- [**Ocean Token Bridge**](https://bridge.oceanprotocol.com)
+
+It's based on the [TokenBridge by POA Network](https://medium.com/poa-network/introducing-the-erc20-to-erc20-tokenbridge-ce266cc1a2d0) (the company), but the user interface was modified to conform to the Ocean Protocol style, and the loaded contracts are fixed to a specific security-checked version.[^1]
+
 This tutorial shows how you can use the token bridge to transfer Ocean Tokens (OCEAN) from the Ethereum Mainnet to the Pacific Network.
 
-## WARNING
-
-**Please Note: At the time of writing, if you transfer your Ocean Tokens to the Pacific Network, then you are putting your Ocean Tokens at risk.**
-
 ## Using the Token Bridge
 
-If you want to transfer OCEAN out of the Ethereum Mainnet, then first you need an Ethereum account with some OCEAN in the Ethereum Mainnet. If you want to get some OCEAN in the Ethereum Mainnet, then see [the page about Ocean Tokens](/concepts/ocean-tokens/).
+> **Please Note: If you transfer your Ocean Tokens to the Pacific Network, then you are putting your Ocean Tokens at risk.**
 
-Below is a screenshot of MetaMask showing an account (with address `0x8…`) which has 500 OCEAN in the Ethereum Mainnet. If you want MetaMask to show OCEAN, then see [the page about using your wallet to manage Ocean Tokens](/tutorials/wallets-and-ocean-tokens/).
+### Ethereum Mainnet → Ocean Pacific
 
-![MetaMask showing an account that has 500.000 OCEAN in the Ethereum Mainnet](./images/tb01.png)
+If you want to transfer OCEAN out of the Ethereum Mainnet, then first you need an Ethereum account with some OCEAN in the Ethereum Mainnet, and be connected to Ethereum Mainnet in MetaMask. If you want to get some OCEAN in the Ethereum Mainnet, then see the page about [Ocean Tokens](/concepts/ocean-tokens/).
 
-To use the token bridge between the Ethereum Mainnet and the Pacific Network, then go to [https://bridge.oceanprotocol.com/](https://bridge.oceanprotocol.com/). You should see something like this:
+Below is a screenshot of MetaMask showing an account (with address `0x8…`) which has 500 OCEAN in the Ethereum Mainnet. If you want MetaMask to show OCEAN, then see the page about [using your wallet to manage Ocean Tokens](/tutorials/wallets-and-ocean-tokens/).
 
-![The token bridge user interface](./images/tb02.png)
+![MetaMask showing an account that has 500 OCEAN in the Ethereum Mainnet](./images/tb01.png)
 
-The above screenshot shows that the account with address `0x8…` has 500.00 OCEAN in the Ethereum Mainnet and 0.00 OCEAN in the Pacific Network.
+To use the token bridge between the Ethereum Mainnet and the Pacific Network, go to [**bridge.oceanprotocol.com**](https://bridge.oceanprotocol.com).
+
+You should see something like this:
+
+![The Ocean token bridge user interface](./images/tb02.png)
+
+The above screenshot shows that the account with address `0x8…` has 500 OCEAN in the Ethereum Mainnet and 0 OCEAN in the Pacific Network.
 
 - Enter the amount of OCEAN you want to transfer (e.g. 1 OCEAN in the screenshot)
 - Click **Transfer**
@@ -39,15 +46,11 @@ A confirmation dialog box like the following should appear.
 
 You should see some status updates like the following.
 
-![A status update: 0/8 Waiting for Block Confirmations…](./images/tb04.png)
-
-![Another status update: 4/8 Waiting for Block Confirmations…](./images/tb05.png)
-
-![Another status update: Validators Verifying Transaction…](./images/tb06.png)
+![A status update: Waiting for Block Confirmations](./images/tb04.png)
 
 If the transfer is a success, then you should see a dialog box like the following.
 
-![Success!](./images/tb07.png)
+![Success!](./images/tb05.png)
 
 Notice how the transaction ID is shown.
 
@@ -55,7 +58,16 @@ Notice how the transaction ID is shown.
 
 If you go back to MetaMask and switch the network to Pacific, then the account's OCEAN balance in Pacific should be higher by the amount just transferred.
 
-![MetaMask showing an account that has 1.000 OCEAN in the Pacific Network](./images/tb08.png)
+![MetaMask showing an account that has 1 OCEAN in the Pacific Network](./images/tb06.png)
 
+### Ocean Pacific → Ethereum Mainnet
 
-[^1]: The code for the Ocean Protocol version of the token bridge UI is in the [oceanprotocol/token-bridge-ui repo on GitHub](https://github.com/oceanprotocol/token-bridge-ui).
+To go the other way around, transfering Ocean Tokens from Pacific back into the Ethereum Mainnet, you simply connect to Pacific in MetaMask.
+
+This will reverse the order of the token bridge networks:
+
+![From Pacific to Ethereum Mainnet](./images/tb07.png)
+
+Then follow the same steps as outlined above.
+
+[^1]: The code for the Ocean Protocol version of the token bridge UI is in the [oceanprotocol/token-bridge-ui](https://github.com/oceanprotocol/token-bridge-ui) repo on GitHub.