diff --git a/docs/docs/contributor/server/basics/folder-architecture.mdx b/docs/docs/contributor/server/basics/folder-architecture.mdx
index c4857b861..4a59213bc 100644
--- a/docs/docs/contributor/server/basics/folder-architecture.mdx
+++ b/docs/docs/contributor/server/basics/folder-architecture.mdx
@@ -53,11 +53,80 @@ Defines custom objects and makes available a GraphQL API (graphql/metadata).
 
 ## Workspace
 
-Generates and serves custom GraphQL schema based on the metadata.
+Generates and serves custom GraphQL schema based on the metadata. 
+
+### Workspace Directory Structure 
+
+```
+workspace
+  └───workspace-schema-builder
+    └───factories 
+    └───graphql-types
+    └───database
+    └───interfaces
+    └───object-definitions
+    └───services
+    └───storage
+    └───utils
+  └───workspace-resolver-builder
+    └───factories
+    └───interfaces
+  └───workspace-query-builder
+    └───factories
+    └───interfaces
+  └───workspace-query-runner
+    └───interfaces
+    └───utils 
+  └───workspace-datasource
+  └───workspace-manager
+  └───workspace-migration-runner          
+  └───utils 
+  └───workspace.module.ts   
+  └───workspace.factory.spec.ts  
+  └───workspace.factory.ts      
+```
 
 
+The root of the workspace directory includes the `workspace.factory.ts`, a file containing the `createGraphQLSchema` function. This function generates workspace-specific schema by using the metadata to tailor a schema for individual workspaces. By separating the schema and resolver construction, we use the `makeExecutableSchema` function, which combines these discrete elements. 
 
+This strategy is not just about organization, but also helps with optimization, such as caching generated type definitions to enhance performance and scalability.
 
+### Workspace Schema builder
 
+Generates the GraphQL schema, and includes:  
 
+#### Factories: 
 
+Specialised constructors to generate GraphQL-related constructs.  
+- The type.factory translates field metadata into GraphQL types using `TypeMapperService`.
+- The type-definition.factory creates GraphQL input or output objects derived from `objectMetadata`.
+
+#### GraphQL Types
+
+Includes enumerations, inputs, objects, and scalars, and serves as the building blocks for the schema construction.
+
+#### Interfaces and Object Definitions
+
+Contains the blueprints for GraphQL entities, and includes both predefined and custom types like `MONEY` or `URL`.
+
+#### Services
+
+Contains the service responsible for associating FieldMetadataType with its appropriate GraphQL scalar or query modifiers.
+
+#### Storage 
+
+Includes the `TypeDefinitionsStorage` class that contains reusable type definitions, preventing duplication of GraphQL types.
+
+### Workspace Resolver Builder 
+
+Creates resolver functions for querying and mutatating the GraphQL schema. 
+
+Each factory in this directory is responsible for producing a distinct resolver type, such as the `FindManyResolverFactory`, designed for adaptable application across various tables.
+
+### Workspace Query Builder 
+
+Includes factories that generate `pg_graphql` queries. 
+
+### Workspace Query Runner 
+
+Runs the generated queries on the database and parses the result.
\ No newline at end of file