Remove instructions and point to dev guide. (#116)

README.md

@@ -85,69 +85,9 @@ There are a few different components to this repo:
 * [spirv-builder](spirv-builder) for a convenient way of building a GPU crate in a CPU build.rs file.
 
 ## Getting started
+We welcome community contributions to this project. If you would like to get started, be sure to checkout the [`rust-gpu` dev guide][gpu-guide] and our [Contributor Guide](CONTRIBUTING.md) for more information on how to get started.
 
-1. Clone the repository.
+[gpu-guide]: https://embarkstudios.github.io/rust-gpu/
-
-1. Install the prerequisites using the provided setup script. From the root of the project, run:
-
-    MacOS, Linux:
-    ```shell
-    sh setup.sh
-    ```
-    
-    Windows:
-    ```
-    setup.bat
-    ```
-    
-    The setup script installs nightly Rust (required for now, see [#78](https://github.com/EmbarkStudios/rust-gpu/issues/78) for tracking issue).
-
-1. Install [SPIRV-Tools](https://github.com/KhronosGroup/SPIRV-Tools#downloads) and add it to your PATH (for now, eventually we will automatically build and link it instead of calling executables)
-
-1. Next, look at the [examples](examples) folder. There are two projects here: [examples/example-shader](examples/example-shader) and [examples/example-runner](examples/example-runner). The example-shader project is a "GPU crate", one that will be compiled to a SPIR-V module. The example-runner project is a normal, CPU crate that uses vulkan to consume the example-shader SPIR-V module to display a shader.
-    
-    Run the example:
-
-    ```shell
-    cargo run --bin example-runner
-    ```
-    
-    This will build `rustc_codegen_spirv`, the compiler, then use that compiler to build `example-shader` into a SPIR-V module, then finally, build a vulkan sample app (taken from [ash's examples](https://github.com/MaikKlein/ash/blob/master/examples/src/bin/triangle.rs)) using the built SPIR-V module to display the shader in a window.
-
-    All of this is orchestrated by the [spirv-builder](spirv-builder) crate, which is used in example-runner's `build.rs` file. Please look at that file, as well as both example projects in general, to see how to set up your own shaders!
-
-Be aware that this project is in a very early phase - if the above doesn't work, please [file an issue](https://github.com/EmbarkStudios/rust-gpu/issues)!
-
-## Getting started, for power users who don't want to use spirv-builder.
-
-If you would like to build the compiler, `rustc_codegen_spirv` is the relevant folder. Install the prerequisites, as above, then, `cd rustc_codegen_spirv && cargo build`. This produces an .so file, located at `./target/debug/librustc_codegen_spirv.so` (or `.dll`/`.dylib` depending on your platform).
-
-This file is a dynamically loaded backend for rustc - you may tell rustc to use it as a backend through the `-Z codegen-backend=...` flag. To pass this to rustc through cargo, set the environment variable `RUSTFLAGS="-Z codegen-backend=$PATH_TO_FILE"`.
-
-Then, when building a GPU crate, we need to configure some flags when we call cargo. First, we need to build libcore
-ourselves - we obviously have no SPIR-V libcore installed on our system! Use the flag `-Z build-std=core`. Then, we need
-to tell rustc to generate SPIR-V instead of x86 code: `--target spirv-unknown-unknown`.
-
-Overall, building your own SPIR-V crate looks like:
-
-```shell
-export RUSTFLAGS="-Zcodegen-backend=$THIS_REPO/target/debug/librustc_codegen_spirv.so"
-cargo build -Z build-std=core --target spirv-unknown-unknown --release
-```
-
-(with an appropriate path for `$THIS_REPO`, and replacing `export` with `set` if you're on windows as well as the proper dll name)
-
-This will produce a `target/spirv-unknown-unknown/release/crate_name.spv` file.
-
-To create a GPU crate, look at the [examples/example-shader](examples/example-shader) crate. In short, reference the `spirv-std` crate, and use intrinsics defined there to create your shader.
-
-This is all a little convoluted, hence the [spirv-builder](spirv-builder) crate handles a lot of this.
-
-## Contributing
-
-We welcome community contributions to this project.
-
-Please read our [Contributor Guide](CONTRIBUTING.md) for more information on how to get started.
 
 ## License
 
@@ -162,4 +102,4 @@ at your option.
 
 Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
 
-[SPIR-V]: https://en.wikipedia.org/wiki/Standard_Portable_Intermediate_Representation
+[SPIR-V]: https://en.wikipedia.org/wiki/Standard_Portable_Intermediate_Representation