stellar-deprecated · leighmcculloch · Jul 29, 2022 · Jul 29, 2022
diff --git a/docs/examples/_category_.json b/docs/examples/_category_.json
@@ -1,4 +1,4 @@
 {
   "position": 3,
-  "label": "Tutorials / Examples"
+  "label": "Examples"
 }
diff --git a/docs/examples/liquidity-pool.mdx b/docs/examples/liquidity-pool.mdx
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 5
 title: Liquidity Pool
 ---
 

diff --git a/docs/examples/single-offer-sale.mdx b/docs/examples/single-offer-sale.mdx
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 4
 title: Single Offer Sale
 ---
 

diff --git a/docs/getting-started/build-a-wasm-file.mdx b/docs/getting-started/build-a-wasm-file.mdx
diff --git a/docs/getting-started/first-project.mdx → docs/getting-started/quick-start.mdx b/docs/getting-started/first-project.mdx → docs/getting-started/quick-start.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_position: 3
-title: First Project
+title: Quick Start
 ---
 
 Once you've [Setup] your development environment, you're ready to create your

diff --git a/docs/guides/_category_.json → docs/learn/_category_.json b/docs/guides/_category_.json → docs/learn/_category_.json
@@ -1,4 +1,4 @@
 {
   "position": 5,
-  "label": "Guides"
+  "label": "Learn"
 }
diff --git a/docs/guides/contract-lifecycle.mdx → docs/learn/contract-lifecycle.mdx b/docs/guides/contract-lifecycle.mdx → docs/learn/contract-lifecycle.mdx
diff --git a/docs/guides/debugging.mdx → docs/learn/debugging.mdx b/docs/guides/debugging.mdx → docs/learn/debugging.mdx
diff --git a/docs/guides/environment-concepts.mdx → docs/learn/environment-concepts.mdx b/docs/guides/environment-concepts.mdx → docs/learn/environment-concepts.mdx
diff --git a/docs/guides/events.mdx → docs/learn/events.mdx b/docs/guides/events.mdx → docs/learn/events.mdx
diff --git a/docs/guides/gas-and-metering.mdx → docs/learn/gas-and-metering.mdx b/docs/guides/gas-and-metering.mdx → docs/learn/gas-and-metering.mdx
diff --git a/docs/guides/high-level-overview.mdx → docs/learn/high-level-overview.mdx b/docs/guides/high-level-overview.mdx → docs/learn/high-level-overview.mdx
diff --git a/docs/guides/interacting-with-contracts-2.mdx → docs/learn/interacting-with-contracts-2.mdx b/docs/guides/interacting-with-contracts-2.mdx → docs/learn/interacting-with-contracts-2.mdx
diff --git a/docs/guides/interacting-with-contracts.mdx → docs/learn/interacting-with-contracts.mdx b/docs/guides/interacting-with-contracts.mdx → docs/learn/interacting-with-contracts.mdx
diff --git a/docs/guides/persisting-data.mdx → docs/learn/persisting-data.mdx b/docs/guides/persisting-data.mdx → docs/learn/persisting-data.mdx
diff --git a/docs/guides/rust-dialect.mdx → docs/learn/rust-dialect.mdx b/docs/guides/rust-dialect.mdx → docs/learn/rust-dialect.mdx
diff --git a/...des/standard-assets-and-authorization.mdx → ...arn/standard-assets-and-authorization.mdx b/...des/standard-assets-and-authorization.mdx → ...arn/standard-assets-and-authorization.mdx
diff --git a/docs/standard-contracts/_category_.json b/docs/standard-contracts/_category_.json
@@ -0,0 +1,4 @@
+{
+  "position": 3,
+  "label": "Standard Contracts"
+}
diff --git a/docs/standard-contracts/token-contract.mdx b/docs/standard-contracts/token-contract.mdx
@@ -0,0 +1,14 @@
+---
+sidebar_position: 1
+title: Token Contract
+---
+
+The token contract is an implementation of [CAP-54 Smart Contract Standardized Asset].
+
+[CAP-54 Smart Contract Standardized Asset]: https://stellar.org/protocol/cap-54
+
+:::caution
+The token contract is in early development, has not been audited, and is not
+intended for use. Report issues
+[here](https://github.com/stellar/soroban-token-contract).
+:::
diff --git a/docs/tutorials/_category_.json b/docs/tutorials/_category_.json
@@ -0,0 +1,4 @@
+{
+  "position": 2,
+  "label": "Tutorials"
+}
diff --git a/...-started/build-an-optimized-wasm-file.mdx → ...utorials/build-an-optimized-wasm-file.mdx b/...-started/build-an-optimized-wasm-file.mdx → ...utorials/build-an-optimized-wasm-file.mdx
diff --git a/docs/getting-started/run-a-wasm-file.mdx → docs/tutorials/build-and-run-a-contract.mdx b/docs/getting-started/run-a-wasm-file.mdx → docs/tutorials/build-and-run-a-contract.mdx
@@ -1,8 +1,24 @@
 ---
-sidebar_position: 7
-title: Run a WASM File
+sidebar_position: 6
+title: Build and Run
 ---
 
+## Build a Contract
+
+To build a Soroban contract into a `.wasm` file, use the `cargo build` command.
+
+```sh
+cargo build --target wasm32-unknown-unknown --release
+```
+
+A `.wasm` file should be outputted in the `target` directory:
+
+```
+target/wasm32-unknown-unknown/release/[project-name].wasm
+```
+
+## Run a Contract
+
 If you have [`soroban-cli`] installed, you can invoke contract functions in a
 WASM file.
 

diff --git a/docs/tutorials/create-a-project.mdx b/docs/tutorials/create-a-project.mdx
@@ -0,0 +1,74 @@
+---
+sidebar_position: 1
+title: Create a Project
+---
+
+Once you've [Setup] your development environment, you're ready to create your
+first Soroban contract.
+
+[Setup]: setup.mdx
+
+Start by creating a new Rust library using the `cargo new` command.
+
+```sh
+cargo new --lib [project-name]
+```
+
+Open the `Cargo.toml`, it should look something like this:
+
+```toml title="Cargo.toml"
+[package]
+name = "first-project"
+version = "0.1.0"
+edition = "2021"
+```
+
+## Add `soroban-sdk` Dependency
+
+Add the following sections to the `Cargo.toml` that will import the `soroban-sdk`.
+
+:::caution
+The `soroban-sdk` is in early development. Report issues
+[here](https://github.com/stellar/rs-soroban-sdk).
+:::
+
+```toml
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[features]
+default = ["export"]
+export = []
+testutils = ["soroban-sdk/testutils"]
+
+[dependencies]
+soroban-sdk = { git = "https://github.com/stellar/rs-soroban-sdk", rev = "32b76650" }
+
+[dev_dependencies]
+first-project = { path = ".", features = ["testutils"] }
+
+[profile.release]
+opt-level = "z"
+overflow-checks = true
+debug = 0
+strip = "symbols"
+debug-assertions = false
+panic = "abort"
+codegen-units = 1
+lto = true
+```
+
+The `features` list and `dev_dependencies` configure three variations that the
+contract can be built with:
+- By `default`, with `export` enabled, contract functions will be exported and
+available to be invoked when the contract is deployed.
+- Optionally without `export` enabled, contract functions will not be exported.
+Types will be still exposed, which is useful when developing multiple contracts
+together and this contract is to be imported into another but its functions are
+not intended to be invoked.
+- And `testutils` which will cause additional test utilities to be generated for
+calling the contract in tests. The library itself is added as a `dev_dependencies`
+so that whenever its tests are running the `testutils` feature is enabled.
+
+The config for the `release` profile configures the Rust toolchain to produce
+smaller contracts.
diff --git a/docs/getting-started/testing.mdx → docs/tutorials/testing.mdx b/docs/getting-started/testing.mdx → docs/tutorials/testing.mdx
diff --git a/docs/getting-started/write-a-contract.mdx → docs/tutorials/write-a-contract.mdx b/docs/getting-started/write-a-contract.mdx → docs/tutorials/write-a-contract.mdx