docs: added docs about config imports

Author: butschster

docs/configuration.md

@@ -13,6 +13,7 @@ Configuration is built around three core concepts:
     - Composer package
     - or Git diffs
 - **Modifiers**: Transform source content before inclusion - clean up, simplify, or enhance raw content
+- **Imports**: Include and merge configuration from external files to enable modular configuration management
 
 ## YAML Configuration Format
 
@@ -106,4 +107,54 @@ Create a `context.json` file in your project root:
 }
 ```
 
-As you can see it's pretty simple.
+As you can see it's pretty simple.
+
+## Configuration Imports
+
+For large projects with multiple components or services, you can split your configuration across multiple files using the import functionality.
+
+- Import paths are resolved relative to the importing file
+- You can apply path prefixes to source paths in imported configurations
+- Imports can be nested (configurations can import other configurations)
+- Circular imports are automatically detected and prevented
+
+### Import Example in YAML
+
+```yaml
+import:
+  - path: services/api/context.yaml
+
+documents:
+  - description: Project Overview
+    outputPath: docs/overview.md
+    sources:
+      - type: text
+        content: |
+          # Project Documentation
+
+          This is the main project documentation.
+```
+
+### Import Example in JSON
+
+```json
+{
+  "import": [
+    {
+      "path": "services/api/context.json"
+    }
+  ],
+  "documents": [
+    {
+      "description": "Project Overview",
+      "outputPath": "docs/overview.md",
+      "sources": [
+        {
+          "type": "text",
+          "content": "# Project Documentation\n\nThis is the main project documentation."
+        }
+      ]
+    }
+  ]
+}
+```

docs/quick-start.md

@@ -55,12 +55,14 @@ name from the `src/Models` directory.
 
 #### Need more advanced configuration?
 
- - Learn about [Document Structure](/documents) and properties
- - Explore different source types like [GitHub](/sources/github-source), [Git Diff](/sources/git-diff-source),
-    or [URL](/sources/url-source)
- - Apply [Modifiers](/modifiers) to transform your content (like extracting PHP signatures)
- - Discover how to use [Environment Variables](/environment-variables) in your config
- - Use [IDE Integration](/getting-started/ide-integration) for autocompletion and validation
+- Learn about [Configuration formats and imports](/configuration) to understand available syntax options (YAML or JSON)
+  and how to organize your setup with modular imports.
+- Learn about [Document Structure](/documents) and properties
+- Explore different source types like [GitHub](/sources/github-source), [Git Diff](/sources/git-diff-source),
+  or [URL](/sources/url-source)
+- Apply [Modifiers](/modifiers) to transform your content (like extracting PHP signatures)
+- Discover how to use [Environment Variables](/environment-variables) in your config
+- Use [IDE Integration](/getting-started/ide-integration) for autocompletion and validation
 
 ## 4. Build the Context