convert README to markdown
[rust-101.git] / README.md
1 # Rust-101
2
3 This documents Rust-101, a tutorial for the [Rust
4 language](http://www.rust-lang.org/). You are probably looking for the
5 [actual tutorial](https://www.ralfj.de/projects/rust-101/main.html).
6
7
8 Usage
9 -----
10
11 You can either read through the sources in `src/`, or generate the
12 HTML in `docs/` using `make docs` (this step needs
13 [Pycco](https://fitzgen.github.io/pycco/)), or go directly to [the
14 rendered output](https://www.ralfj.de/projects/rust-101/main.html).
15
16 The files `workspace/src/part*.rs` are generated by `make workspace`.
17
18 Source, License
19 ---------------
20
21 You can find the sources in the [git
22 repository](http://www.ralfj.de/git/rust-101.git) (also available [on
23 GitHub](https://github.com/RalfJung/rust-101)).  They are provided
24 under a Creative Commons Attribution-ShareAlike 4.0 International
25 license ([CC-BY-SA
26 4.0](https://creativecommons.org/licenses/by-sa/4.0/)). See the file
27 `LICENSE-CC` for more details.
28
29 Contact
30 -------
31
32 If you found a bug, or want to leave a comment, please [send me a
33 mail](mailto:post-AT-ralfj-DOT-de). I'm also happy about pull requests
34 :)