diff --git a/convertlogtimestamp.sh b/scripts/convertlogtimestamp.sh
similarity index 94%
rename from convertlogtimestamp.sh
rename to scripts/convertlogtimestamp.sh
index 9263f7e..da97d4d 100755
--- a/convertlogtimestamp.sh
+++ b/scripts/convertlogtimestamp.sh
@@ -1,5 +1,6 @@
 #!/usr/bin/env sh
 # Converts ROS2 log data timestamps from stdin to more readable format
+# Reads lines from stdin, pipe input to this script
 
 
 while IFS= read -r string; do
diff --git a/gen-docs.sh b/scripts/gen-docs.sh
similarity index 84%
rename from gen-docs.sh
rename to scripts/gen-docs.sh
index 7bb2793..106b895 100755
--- a/gen-docs.sh
+++ b/scripts/gen-docs.sh
@@ -1,4 +1,7 @@
 #!/usr/bin/env sh
+# generates docs
+
+pushd ..
 
 pushd src/robot_controller/
 doxygen
@@ -13,3 +16,5 @@ doxygen
 popd
 
 make html
+
+