diff --git a/dartwrf/prepare_wrfrundir.py b/dartwrf/prepare_wrfrundir.py
index 99690da25d95afb52193fbee101a786fa29bbf55..f1180708dbb267c223a10aeb69e2abe3caee4338 100755
--- a/dartwrf/prepare_wrfrundir.py
+++ b/dartwrf/prepare_wrfrundir.py
@@ -1,7 +1,11 @@
-"""Prepare WRF run directories, to use wrf.exe then
+"""Prepare WRF run directories, to use wrf.exe later
+Creates a directory where WRF will run (temporary);
+Creates softlinks from WRF's `run/` directory;
+Links executables set in `cluster.ideal` and `cluster.wrfexe`;
+If `exp.input_profile` is set, links the input profiles.
 
 Args:
-    init_time (str): YYYY-MM-DD_HH:MM
+    init_time (str): Initialization time in format YYYY-MM-DD_HH:MM
 
 Returns:
     None
diff --git a/dartwrf/wrfinput_add_geo.py b/dartwrf/wrfinput_add_geo.py
index aa1400c8513bb77ba7d38559c545e5474693f0a5..6d9284ee6ccb539866144f502c1ddeaa5e0044a0 100755
--- a/dartwrf/wrfinput_add_geo.py
+++ b/dartwrf/wrfinput_add_geo.py
@@ -1,8 +1,8 @@
-"""Add geogrid data to wrfinput
-this is needed for DART, but not provided by ideal.exe
+"""Add geogrid data to wrfinput. 
+DART needs a georeference, but ideal.exe does not provide it
 
-take LAT,LON, mapfac from geogrid, so that they are consistent.
-do not change E, F, HGT_M as they would alter the dynamics and have no impact on assimilation
+Takes LAT,LON, mapfac from geogrid, so that they are consistent.
+Does not change E, F, HGT_M as they would alter the dynamics and have no impact on assimilation
 
 example call:
     ./wrfinput_add_geo.py geo_em.d01.nc wrfinput_d01
diff --git a/dartwrf/wrfout_add_geo.py b/dartwrf/wrfout_add_geo.py
index 8be29aad65e379b92a7122ebac1fbd6d65b1af34..86c7ae8417ee41edea4d5cd9a6d63b524f433934 100755
--- a/dartwrf/wrfout_add_geo.py
+++ b/dartwrf/wrfout_add_geo.py
@@ -8,7 +8,7 @@ fields_new = ["XLAT",     "XLONG",      "CLAT",
                 "XLONG_U",  "XLONG_V",     "XLAT_U",    "XLAT_V"]
 
 def run(geo_data_file, wrfout_file):
-    """Add geogrid data to wrfinput
+    """Add geogrid data to a wrfout file
     DART needs a georeference, but ideal.exe does not provide it
 
     Takes LAT,LON, mapfac from geogrid, so that they are consistent.