Update content

oasisprotocol · Oct 3, 2023 · d18e29c · d18e29c
1 parent 7b01ef8
commit d18e29c
Show file tree

Hide file tree

Showing 3 changed files with 22 additions and 12 deletions.
diff --git a/docs/dapp/emerald/writing-dapps-on-emerald.mdx b/docs/dapp/emerald/writing-dapps-on-emerald.mdx
@@ -384,14 +384,13 @@ share them with us on the [#emerald-paratime Discord channel][discord].
 
 Per Consensys [announcement], Oasis will no longer support Truffle as of
 2023-10-05 and encourage immediate [migration] to Hardhat. Please see our
-repository for the archived Truffle [tutorial] and the deprecated [example].
+repository for the archived Truffle [tutorial].
 
 :::
 
 [announcement]: https://consensys.io/blog/consensys-announces-the-sunset-of-truffle-and-ganache-and-new-hardhat
 [migration]: https://trufflesuite.com/docs/truffle/how-to/migrate-to-hardhat/
-[tutorial]: https://github.com/oasisprotocol/docs/blob/2f4a1a3c217b82687ab9440bf051762ae369ed45/docs/dapp/sapphire/quickstart.mdx
-[example]: https://github.com/oasisprotocol/sapphire-paratime/tree/3a85e42e6c1cc090c28a521cf7df6353aa8a30c8/examples/truffle
+[tutorial]: https://github.com/oasisprotocol/docs/blob/207a7b1a42b4afdac70b925e755f5546723e4831/docs/dapp/emerald/writing-dapps-on-emerald.mdx#L330-L570
 
 ### Deployment of my contract timed out on Testnet or Mainnet
 
@@ -405,9 +404,9 @@ required gas price on Emerald. This value should already be propagated
 automatically by the web3 endpoint, but your deployment configuration might
 have ignored it.
 
-Finally, consider increasing the `gasPrice` parameter in Hardhat config files
-by a fraction (e.g. 10% or 20%). This will require more ROSE from your wallet
-to deploy the contract, but you will also increase the chance of your
+Finally, consider increasing the `gasPrice` parameter in the Hardhat config
+file by a fraction (e.g. 10% or 20%). This will require more ROSE from your
+wallet to deploy the contract, but you will also increase the chance of your
 transaction being included in the block.
 
 ### Execution of my contract failed. How do I debug what went wrong?

diff --git a/docs/dapp/sapphire/guide.mdx b/docs/dapp/sapphire/guide.mdx
@@ -121,7 +121,7 @@ it'll work just fine.
 ### Languages & Frameworks
 
 Sapphire is programmable using any language that targets the EVM, such as Solidity
-and Vyper. If you prefer to use an Ethereum framework like Hardhat or Foundry, you
+or Vyper. If you prefer to use an Ethereum framework like Hardhat or Foundry, you
 can also use those with Sapphire; all you need to do is set your Web3 gateway URL.
 You can find the details of the Oasis Sapphire Web3 gateway
 [here](/dapp/sapphire#web3-gateway).

diff --git a/docs/dapp/sapphire/quickstart.mdx b/docs/dapp/sapphire/quickstart.mdx
@@ -91,15 +91,17 @@ index 414e974..49c95f9 100644
 ```
 
 By importing `@oasisprotocol/sapphire-hardhat` at the top of the config file,
-any network config entry corresponding to the Sapphire's chain ID will
+**any network config entry corresponding to the Sapphire's chain ID will
 automatically be wrapped with Sapphire specifics for encrypting and signing the
-transactions.
+transactions**.
 
-#### Get some Sapphire Testnet tokens
+### Get some Sapphire Testnet tokens
 
 Now for the fun part. We need to configure the Sapphire network and get some tokens.
-Hit up the one and only [Oasis Testnet faucet] and this time select "Sapphire".
-Submit the form and on your way.
+Hit up the one and only [Oasis Testnet faucet] and select "Sapphire".
+Submit the form and be on your way.
+
+[Oasis Testnet faucet]: https://faucet.testnet.oasis.dev
 
 ### Get the Contract
 
@@ -184,6 +186,15 @@ example of this quickstart.
 
 :::
 
+:::info Example
+
+If your project involves building a web frontend, we recommend that you check
+out the official [Oasis starter] files.
+
+[Oasis starter]: https://github.com/oasisprotocol/demo-starter
+
+:::
+
 ## See also
 
 <DocCard item={findSidebarItem('/dapp/sapphire/browser')} />