diff --git a/README.md b/README.md
index 5eaecf9..bb3596b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
+# Oxidized Kilo
+
 An experimental reimplementation of the [Kilo](https://viewsourcecode.org/snaptoken/kilo/index.html)
-tutorial with a Rust implementation.
\ No newline at end of file
+tutorial with a Rust implementation.
+
+## Implementation notes:
+* The `editor` prefix has been removed from all the editor methods. Since this implementation
+uses `impl`s on a shared `Editor` struct, the prefix is redundant
+* Any C equivalent functionality based on memory allocating/deallocating, or other manual book-keeping is instead
+implemented in a more idiomatic Rust fashion.
+
+
+### Known issues:
+* The cursor is invisible :(
\ No newline at end of file