diff --git a/README.md b/README.md
index 8373ddb..0a0886a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,8 @@
# OpenQASM 3 Parser
+[](https://opensource.org/licenses/Apache-2.0)
+[](https://rust-lang.github.io/rfcs/2495-min-rust-version.html)
+[](https://crates.io/crates/oq3_semantics)
+
This project provides a compiler front end for OpenQASM 3 language (OQ3).
@@ -10,20 +14,6 @@ Differences with the [OpenQASM reference parser](https://github.com/openqasm/ope
A crude test with large source files showed parse time reduced by a factor of 80.
* `openqasm3_parser` performs semantic analysis.
-
- What is a rust "crate"
-
-We talk about rust ["crates"](https://doc.rust-lang.org/book/ch07-01-packages-and-crates.html).
-A rust library crate is more or less the source for a rust library that is developed, built, and installed with the rust package manager [cargo](https://doc.rust-lang.org/cargo/).
-This single repository contains more than one separately installable crates. In the future, this repository may also be used to generate other artifacts.
-
-
-
-### Status
-
-There have been no releases of any kind. I'll try to keep something more or less meaningful in this spot.
-For instance, I hope to soon replace "I" with "we".
-
### Crates (roughly one installable library per crate)
The first three crates are based on tools for `rust` and `rust-analyzer`.
@@ -41,6 +31,16 @@ There are other names for this structure. But "ASG" is convenient.
* [oq3_source_file](./crates/oq3_source_file) -- A higher-level interface to the syntactic AST. This sits beetween the syntactic AST and
semantic ASG. This crate manages the main source file and incuded source files.
+
+ What is a rust "crate"
+
+We talk about rust ["crates"](https://doc.rust-lang.org/book/ch07-01-packages-and-crates.html).
+A rust library crate is more or less the source for a rust library that is developed, built, and installed with the rust package manager [cargo](https://doc.rust-lang.org/cargo/).
+This single repository contains more than one separately installable crates. In the future, this repository may also be used to generate other artifacts.
+
+
+
+
### Warning !
Do not run `cargo test`. Rather use `./run_tests.sh` or commands found therein. This is because codegen is implemented via