Preparation for sharing

- rustfmt
- clippy
- comments
- README

README.md

@@ -1,5 +1,29 @@
-All you need to run the project is a nighly rust toolchain. Go to one of the folders within `examples` and run
+Orchid is an experimental lazy, pure functional programming language designed to be embeddable in a Rust application for scripting.
+
+# Usage
+
+TODO
+
+I need to write a few articles explaining individual fragments of the language, and accurately document everything. Writing tutorials at this stage is not really worth it.
+
+# Design
+
+The execution model is lambda calculus, with call by name and copy tracking to avoid repeating steps. This leads to the minimal number of necessary reduction steps.
+
+To make the syntax more intuitive, completely hygienic macros can be used which are applied to expressions after all imports are resolved and all tokens are namespaced both in the macro and in the referencing expression.
+
+Namespaces are inspired by Rust modules and ES6. Every file and directory is implicitly a public module. Files can `export` names of constants or namespaces, all names in a substitution rule, or explicitly export some names. Names are implicitly created when they're referenced. `import` syntax is similar to Rust except with `(` parentheses `)` and no semicolons.
+
+# Try it out
+
+The project uses the nighly rust toolchain. Go to one of the folders within `examples` and run
 
 ```sh
 cargo run -- -p .
-```
+```
+
+you can try modifying the examples, but error reporting for the time being is pretty terrible.
+
+# Contribution
+
+All contributions are welcome. For the time being, use the issue tracker to discuss ideas.