diff --git a/lib/private/files/cache/propagator.php b/lib/private/files/cache/propagator.php
index 673d7901027c..bd11cef5990d 100644
--- a/lib/private/files/cache/propagator.php
+++ b/lib/private/files/cache/propagator.php
@@ -21,6 +21,9 @@
 
 namespace OC\Files\Cache;
 
+/**
+ * Propagate etags and mtimes within the storage
+ */
 class Propagator {
 	/**
 	 * @var \OC\Files\Storage\Storage
diff --git a/lib/private/files/view.php b/lib/private/files/view.php
index 0c0c86b2a764..8d4efe20bc49 100644
--- a/lib/private/files/view.php
+++ b/lib/private/files/view.php
@@ -1160,6 +1160,11 @@ public function hasUpdated($path, $time) {
 	}
 
 	/**
+	 * Get file info from cache
+	 *
+	 * If the file is not in cached it will be scanned
+	 * If the file has changed on storage the cache will be updated
+	 *
 	 * @param \OC\Files\Storage\Storage $storage
 	 * @param string $internalPath
 	 * @param string $relativePath