diff --git a/Neos.ContentRepository.Core/Classes/ContentRepository.php b/Neos.ContentRepository.Core/Classes/ContentRepository.php
index 96b3025f57a..d1262979d40 100644
--- a/Neos.ContentRepository.Core/Classes/ContentRepository.php
+++ b/Neos.ContentRepository.Core/Classes/ContentRepository.php
@@ -244,11 +244,18 @@ public function getContentGraph(WorkspaceName $workspaceName): ContentGraphInter
         return $this->projectionState(ContentGraphFinder::class)->getByWorkspaceName($workspaceName);
     }
 
+    /**
+     * Returns the workspace with the given name, or NULL if it does not exist in this content repository
+     */
     public function findWorkspaceByName(WorkspaceName $workspaceName): ?Workspace
     {
         return $this->getWorkspaceFinder()->findOneByName($workspaceName);
     }
 
+    /**
+     * Returns all workspaces of this content repository. To limit the set, {@see Workspaces::find()} and {@see Workspaces::filter()} can be used
+     * as well as {@see Workspaces::getBaseWorkspaces()} and {@see Workspaces::getDependantWorkspaces()}.
+     */
     public function findWorkspaces(): Workspaces
     {
         return $this->getWorkspaceFinder()->findAll();