Add comments about dev/Cargo.toml

2 files changed, 13 insertions, 1 deletions

diff --git a/dev/Cargo.toml b/dev/Cargo.toml
index 4ad4886..e4e7be7 100644
--- a/dev/Cargo.toml
+++ b/dev/Cargo.toml
@@ -1,3 +1,6 @@
+# This file is a hack to allow using `cargo r` to test `rustlings` during development.
+# You shouldn't edit it manually. It is created and updated by running `cargo run --bin gen-dev-cargo-toml`.
+
 bin = [
   { name = "intro1", path = "../exercises/00_intro/intro1.rs" },
   { name = "intro2", path = "../exercises/00_intro/intro2.rs" },
diff --git a/src/bin/gen-dev-cargo-toml.rs b/src/bin/gen-dev-cargo-toml.rs
index 20167a1..65cc244 100644
--- a/src/bin/gen-dev-cargo-toml.rs
+++ b/src/bin/gen-dev-cargo-toml.rs
@@ -1,3 +1,7 @@
+// Generates `dev/Cargo.toml` such that it is synced with `info.toml`.
+// `dev/Cargo.toml` is a hack to allow using `cargo r` to test `rustlings`
+// during development.
+
 use anyhow::{bail, Context, Result};
 use serde::Deserialize;
 use std::{
@@ -25,7 +29,12 @@ fn main() -> Result<()> {
 
     let mut buf = Vec::with_capacity(1 << 14);
 
-    buf.extend_from_slice(b"bin = [\n");
+    buf.extend_from_slice(
+        b"# This file is a hack to allow using `cargo r` to test `rustlings` during development.
+# You shouldn't edit it manually. It is created and updated by running `cargo run --bin gen-dev-cargo-toml`.
+
+bin = [\n",
+    );
 
     for exercise in exercises {
         buf.extend_from_slice(b"  { name = \"");