Add some more tutorial documentation (#60)

Author: armaniferrante

docs/src/.vuepress/config.js

@@ -42,19 +42,26 @@ module.exports = {
         title: "Getting Started",
         children: [
           "/getting-started/introduction",
-					"/getting-started/installation",
-					"/getting-started/quick-start",
+          "/getting-started/installation",
         ],
       },
       {
         collapsable: false,
-        title: "Tutorials",
-				children: [
+        title: "Programs on Solana",
+        children: [
           "/tutorials/tutorial-0",
           "/tutorials/tutorial-1",
           "/tutorials/tutorial-2",
           "/tutorials/tutorial-3",
           "/tutorials/tutorial-4",
+          "/tutorials/tutorial-5",
+        ],
+      },
+      {
+        collapsable: false,
+        title: "CLI",
+        children: [
+          "/cli/commands",
         ],
       },
     ],

docs/src/cli/commands.md

@@ -0,0 +1,195 @@
+# Commands
+
+A CLI is provided to support building and managing an Anchor workspace.
+For a comprehensive list of commands and options, run `anchor -h` on any
+of the following subcommands.
+
+```
+anchor-cli
+
+USAGE:
+    anchor <SUBCOMMAND>
+
+FLAGS:
+    -h, --help       Prints help information
+    -V, --version    Prints version information
+
+SUBCOMMANDS:
+    build      Builds the workspace
+    deploy     Deploys each program in the workspace
+    idl        Commands for interacting with interface definitions
+    init       Initializes a workspace
+    launch     Deploys, initializes an IDL, and migrates all in one command
+    migrate    Runs the deploy migration script
+    new        Creates a new program
+    test       Runs integration tests against a localnetwork
+    upgrade    Upgrades a single program. The configured wallet must be the upgrade authority
+```
+
+## Init
+
+```
+anchor init
+```
+
+Initializes a project workspace wit the following structure.
+
+* `Anchor.toml`: Anchor configuration file.
+* `programs/`: Directory for Solana program crates.
+* `app/`: Directory for your application frontend.
+* `tests/`: Directory for JavaScript integration tests.
+* `migrations/deploy.js`: Deploy script.
+
+## Build
+
+```
+anchor build
+```
+
+Builds programs in the workspace targeting Solana's BPF runtime and emitting IDLs in the `target/idl` directory.
+
+## Deploy
+
+```
+anchor deploy
+```
+
+Deploys all programs in the workspace to the configured cluster.
+
+::: tip Note
+This is different from the `solana program deploy` command, because everytime it's run
+it will generate a *new* program address.
+:::
+
+## Upgrade
+
+```
+anchor upgrade <target/deplooy/program.so> --program-id <program-id>
+```
+
+Uses Solana's upgradeable BPF loader to upgrade the on chain program code.
+
+## Test
+
+```
+anchor test
+```
+
+Run an integration test suit against the configured cluster, deploying new versions
+of all workspace programs before running them.
+
+If the configured network is a localnet, then automatically starts the localnetwork and runs
+the test.
+
+::: tip Note
+The Anchor workflow [recommends](https://www.parity.io/paritys-checklist-for-secure-smart-contract-development/)
+to test your program using integration tests in a language other
+than Rust to make sure that bugs related to syntax misunderstandings
+are coverable with tests and not just replicated in tests.
+:::
+
+## Migrate
+
+```
+anchor migrate
+```
+
+Runs the deploy script located at `migrations/deploy.js`, injecting a provider configured
+form the workspace's `Anchor.toml`. For example,
+
+```javascript
+// File: migrations/deploys.js
+
+const anchor = require("@project-serum/anchor");
+
+module.exports = async function (provider) {
+  anchor.setProvider(provider);
+
+  // Add your deploy script here.
+}
+```
+
+Migrations are a new feature
+and only support this simple deploy script at the moment.
+
+## Idl
+
+The `idl` subcommand provides commands for interacting with interface definition files.
+It's recommended to use these commands to store an IDL on chain, at a deterministic
+address, as a function of nothing but the the program's ID. This
+allow us to generate clients for a program using nothing but the program ID.
+
+### Idl Init
+
+```
+anchor idl init -f <target/idl/program.json> <program-id>
+```
+
+Creates an idl account, writing the given `<target/idl/program.json>` file into a program owned account. By default, the size of the account is double the size of the IDL,
+allowing room for growth in case the idl needs to be upgraded in the future.
+
+### Idl Fetch
+
+```
+anchor idl fetch -o <out-file.json> <program-id>
+```
+
+Fetches an IDL from the configured blockchain. For example, make sure
+your `Anchor.toml` is pointing to the `mainnet` cluster and run
+
+```
+anchor idl fetch GrAkKfEpTKQuVHG2Y97Y2FF4i7y7Q5AHLK94JBy7Y5yv
+```
+
+### Idl Authority
+
+```
+anchor idl authority <program-id>
+```
+
+Outputs the IDL account's authority. This is the wallet that has the ability to
+update the IDL.
+
+### Idl Erase Authority
+
+```
+anchor idl erase-authority -p <program-id>
+```
+
+Erases the IDL account's authority so that upgrades can no longer occur. The
+configured wallet must be the current authority.
+
+### Idl Upgrade
+
+```
+anchor idl upgrade <program-id> -f <target/idl/program.json>
+```
+
+Upgrades the IDL file on chain to the new `target/idl/program.json` idl.
+The configured wallet must be the current authority.
+
+```
+anchor idl set-authority -n <new-authority> -p <program-id>
+```
+
+Sets a new authority on the IDL account. Both the `new-authority` and `program-id`
+must be encoded in base 58.
+
+## Launch
+
+```
+anchor launch
+```
+
+Builds, deploys and migrates, all in one command. This is particularly
+useful when simultaneously developing an app against a Localnet or Devnet. For mainnet, it's
+recommended to run each command separately, since transactions can sometimes be
+unreliable depending on the Solana RPC node being used.
+
+## New
+
+```
+anchor new <program-name>
+```
+
+Creates a new program in the workspace's `programs/` directory initialized with boilerplate.

docs/src/getting-started/installation.md

@@ -15,10 +15,10 @@ rustup component add rustfmt
 
 ## Install Solana
 
-See the solana [docs](https://docs.solana.com/cli/install-solana-cli-tools) for installation instructions. Version 1.5.0 is required. On macOS and Linux,
+See the solana [docs](https://docs.solana.com/cli/install-solana-cli-tools) for installation instructions. Version 1.5.5 is required. On macOS and Linux,
 
 ```bash
-sh -c "$(curl -sSfL https://release.solana.com/v1.5.0/install)"
+sh -c "$(curl -sSfL https://release.solana.com/v1.5.5/install)"
 ```
 
 ## Install Mocha

docs/src/getting-started/introduction.md

@@ -2,7 +2,7 @@
 
 Anchor is a framework for Solana's [Sealevel](https://medium.com/solana-labs/sealevel-parallel-processing-thousands-of-smart-contracts-d814b378192) runtime providing several convenient developer tools.
 
-- Rust crates and DSL for writing Solana programs
+- Rust crates and eDSL for writing Solana programs
 - [IDL](https://en.wikipedia.org/wiki/Interface_description_language) specification
 - TypeScript package for generating clients from IDL
 - CLI and workspace management for developing complete applications

docs/src/getting-started/quick-start.md

@@ -1,4 +1,4 @@
-# Tutorial 0: A Minimal Example
+# A Minimal Example
 
 Here, we introduce Anchor's core syntax elements and project workflow. This tutorial assumes all
 [prerequisites](../getting-started/installation.md) are installed.
@@ -65,7 +65,7 @@ anchor build
 The `build` command is a convenience combining two steps.
 
 1) `cargo build-bpf`
-2) `anchor idl -f program/src/lib.rs -o target/idl/basic_0.json`.
+2) `anchor idl parse -f program/src/lib.rs -o target/idl/basic_0.json`.
 :::
 
 Once run, you should see your build artifacts, as usual, in your `target/` directory. Additionally,

docs/src/tutorials/tutorial-0.md

@@ -1,4 +1,4 @@
-# Tutorial 1: Arguments and Accounts
+# Arguments and Accounts
 
 This tutorial covers the basics of creating and mutating accounts using Anchor.
 It's recommended to read [Tutorial 0](./tutorial-0.md) first, as this tutorial will