diff --git a/.gitignore b/.gitignore
index ea8c4bf..088ba6b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,10 @@
-/target
+# Generated by Cargo
+# will have compiled files and executables
+/target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2211bc8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,2 @@
+# va108xx-hal-rs
+Rust Hardware Abstraction Layer (HAL) crate for the Vorago VA108xx family of MCUs