diff --git a/src/core/fs.nim b/src/core/fs.nim
index d202f57..9350c5d 100644
--- a/src/core/fs.nim
+++ b/src/core/fs.nim
@@ -155,7 +155,7 @@ proc removeDirectory*(directory: Directory) =
 
 
 proc parseFileSystemTable*(fstab: string): seq[Filesystem] =
-    ## Parses the contents of the given filesystem table and returns a Filesystem object.
+    ## Parses the contents of the given filesystem table and returns a list of Filesystem objects.
     ## An improperly formatted or semantically invalid fstab will cause this function to 
     ## error out with a ValueError exception that should be caught by the caller.
     ## No other checks other than very basic syntax are performed, as that job
diff --git a/src/core/services.nim b/src/core/services.nim
index f33c155..fcc30eb 100644
--- a/src/core/services.nim
+++ b/src/core/services.nim
@@ -108,11 +108,10 @@ proc resolve(logger: Logger, node: Service): seq[Service] =
     ## sorted list such that a service appears in it only
     ## after all of its dependencies and only
     ## before all of its dependents.
-    ## This function also automatically handles
-    ## detached subgraphs, which can occurr if
-    ## one or more dependencies have common
-    ## dependencies/dependents between each other,
-    ## but not with the rest of the graph. Nodes
+    ## This function is called iteratively by resolveDependencies
+    ## to handle detached subgraphs, which can occurr if one or
+    ## more dependencies have common dependencies/dependents between 
+    ## each other, but not with the rest of the graph. Nodes
     ## that have no dependencies nor provide any
     ## service may be located anywhere in the list,
     ## as that does not invalidate the invariants