some work on the intro
[rust-101.git] / README.rst
index ae56d3f6dafd9212c764d339da0d200b672407bf..9ce06853274714a04eb344fe651fd894103a2e4b 100644 (file)
@@ -1,10 +1,28 @@
 Rust-101
 ========
 
 Rust-101
 ========
 
-This is Rust-101, a tutorial for the `Rust language`_. You can either read 
-through the sources in ``src/``, or generate the HTML in ``docs/`` using ``docco 
-src/*.rs`` (this step needs Docco_), or go directly to `the rendered output`_.
+This is Rust-101, a tutorial for the `Rust language`_.
 
 .. _Rust language: http://www.rust-lang.org/
 
 .. _Rust language: http://www.rust-lang.org/
+
+Usage
+-----
+
+You can either read through the sources in ``src/``, or generate the HTML in 
+``docs/`` using ``make docs`` (this step needs Docco_), or go directly to 
+`the rendered output`_.
+
 .. _Docco: https://jashkenas.github.io/docco/
 .. _Docco: https://jashkenas.github.io/docco/
-.. _the rendered output: https://ralfjung.github.io/rust-101/main.html
+.. _the rendered output: https://www.ralfj.de/projects/rust-101/main.html
+
+Source, License
+---------------
+
+You can find the sources in the `git repository`_ (also available `on GitHub`_). 
+They are provided under a Creative Commons Attribution-ShareAlike 4.0 
+International license (`CC-BY-SA 4.0`_). See the file ``LICENSE-CC`` for more 
+details.
+
+.. _git repository: http://www.ralfj.de/git/rust-101.git
+.. _on GitHub: https://github.com/RalfJung/rust-101
+.. _CC-BY-SA 4.0: https://creativecommons.org/licenses/by-sa/4.0/