diff --git a/notes.md b/notes.md
new file mode 100644
index 0000000..8883403
--- /dev/null
+++ b/notes.md
@@ -0,0 +1,18 @@
+# FLASHING
+flashing is done using the [`wlink`](https://github.com/ch32-rs/wlink?tab=readme-ov-file#install) utility. `probe-rs` also works, but can be flaky, and does not support SDI prints very well.
+
+the `wlink` utility will automatically detect the correct chip, but if it doesn't you can specify it with an additional argument. 
+
+`wlink --help` lists all the options to the `wlink` utility. 
+
+## DEVELOPMENT
+when building using the rust toolchain, you can simply add the following to your `.cargo/config.toml`:
+`runner = "wlink -v flash`
+
+if you want to monitor prints via SDI, you can use the following instead:
+`runner = "wlink -v flash --enable-sdi-print --watch-serial"`
+
+## STANDALONE
+when flashing standalone with the `wlink` utility, you can simply run the following:
+`wlink -v flash <PATH_TO_BINARY>`
+