Reshuffle some files

README.md

@@ -7,16 +7,21 @@ A Python Interpreter written in Rust :snake: :scream: :metal:.
 
 To test RustPython, do the following:
 
-    git clone https://github.com/RustPython/RustPython
-    cd RustPython
-    cargo run demo.py
+    $ git clone https://github.com/RustPython/RustPython
+    $ cd RustPython
+    $ cargo run demo.py
+    42
 
 Or use pip to install extra modules:
 
-    cargo run -m pip install requests
+    $ cargo run -m pip install requests
 
 # Code organization
 
+    - parser: python lexing, parsing and ast
+    - vm: python virtual machine
+    - src: using the other subcrates to bring rustpython to life.
+
 The files in the top level directory are from [windelbouwman/rspython][rspython] which contains an implementation of the parser and vm in `src/`
 
 An alternative implementation of python virtual machine that are compatible with CPython parser are from [shinglyu/RustPython][rustpython] and is located in the `VM/` folder.
@@ -28,6 +33,7 @@ We are in the process of merging the two implementation to form a single impleme
 Chat with us on [gitter][gitter].
 
 # Credit
+
 The initial work was based on [windelbouwman/rspython](https://github.com/windelbouwman/rspython) and [shinglyu/RustPython](https://github.com/shinglyu/RustPython)
 
 [rspython]: https://github.com/windelbouwman/rspython

tests/README.md

@@ -0,0 +1,15 @@
+
+# Test snippets
+
+This directory contains a set of test snippets which can be run in python.
+
+
+## Running with CPython + RustPython
+
+One way to run these snippets is by using CPython to do the parsing and
+compilation to bytecode. When this is done, run the bytecode with rustpython.
+
+## Running with RustPython
+
+The other option is to run all snippets with RustPython.
+