drf-to-mkdoc 0.2.4__py3-none-any.whl → 0.3.1__py3-none-any.whl

drf_to_mkdoc/conf/defaults.py

@@ -2,6 +2,7 @@ DEFAULTS = {
     # Path configurations with defaults
     "DOCS_DIR": "docs",  # Directory where docs will be generated
     "CONFIG_DIR": "docs/configs",  # Directory for configuration files
+    "ER_DIAGRAMS_DIR": "er_diagrams",  # Directory for ER diagrams (relative to DOCS_DIR)
     "MODEL_DOCS_FILE": "docs/model-docs.json",  # Path to model documentation JSON file
     "DOC_CONFIG_FILE": "docs/configs/doc_config.json",  # Path to documentation configuration file
     "CUSTOM_SCHEMA_FILE": "docs/configs/custom_schema.json",  # Path to custom schema file
@@ -13,6 +14,5 @@ DEFAULTS = {
     "AI_CONFIG_DIR_NAME": "ai_code",  # Directory name for AI-generated code files
     "AI_OPERATION_MAP_FILE": "docs/configs/operation_map.json",  # Path to operation map file
     "SERIALIZERS_INHERITANCE_DEPTH": 1,  # Maximum depth for class inheritance analysis
-    # Django apps - required, no default
-    "DJANGO_APPS": None,  # List of Django app names to process
+    "DJANGO_APPS": [],  # If it is empty list, there is no any exclusion
 }

drf_to_mkdoc/conf/settings.py

@@ -7,13 +7,14 @@ from drf_to_mkdoc.conf.defaults import DEFAULTS
 
 
 class DRFToMkDocSettings:
-    required_settings: ClassVar[list[str]] = ["DJANGO_APPS"]
+    required_settings: ClassVar[list[str]] = []
     project_settings: ClassVar[dict[str, Any]] = {"PROJECT_NAME": "drf-to-mkdoc"}
 
     settings_types: ClassVar[dict[str, type]] = {
         "ENABLE_AI_DOCS": bool,
         "AI_CONFIG_DIR_NAME": str,
         "SERIALIZERS_INHERITANCE_DEPTH": int,
+        "DJANGO_APPS": list,
     }
 
     settings_ranges: ClassVar[dict[str, tuple[int, int]]] = {
@@ -22,6 +23,7 @@ class DRFToMkDocSettings:
 
     path_settings = {
         "CONFIG_DIR",
+        "ER_DIAGRAMS_DIR",
         "MODEL_DOCS_FILE",
         "DOC_CONFIG_FILE",
         "CUSTOM_SCHEMA_FILE",

drf_to_mkdoc/management/commands/build_model_docs.py

@@ -4,6 +4,7 @@ from django.core.management.base import BaseCommand
 
 from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
 from drf_to_mkdoc.utils.commons.file_utils import load_json_data
+from drf_to_mkdoc.utils.er_diagram_generator import generate_er_diagrams
 from drf_to_mkdoc.utils.model_detail_generator import generate_model_docs
 from drf_to_mkdoc.utils.model_list_generator import create_models_index
 
@@ -42,9 +43,17 @@ class Command(BaseCommand):
         self.stdout.write("📋 Generating model documentation...")
 
         try:
+            # Generate model detail pages
             generate_model_docs(models_data)
+            self.stdout.write(self.style.SUCCESS("✅ Model detail pages generated"))
+
+            # Generate ER diagrams
+            generate_er_diagrams(models_data, docs_dir)
+            self.stdout.write(self.style.SUCCESS("✅ ER diagrams generated"))
+
+            # Create models index page
             create_models_index(models_data, docs_dir)
-            self.stdout.write(self.style.SUCCESS("✅ Model documentation generated"))
+            self.stdout.write(self.style.SUCCESS("✅ Models index page generated"))
         except Exception as e:
             self.stdout.write(self.style.WARNING(f"⚠️  Failed to generate model docs: {e}"))
             raise

drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/request-executor.js

@@ -160,9 +160,25 @@ const RequestExecutor = {
             }
         }
 
-        // Get method
+        // Get method - try multiple sources for reliability
+        let method = 'GET'; // Default fallback
+        
+        // First try: method badge data attribute
         const methodBadge = document.querySelector('.method-badge');
-        const method = methodBadge?.dataset.method || 'GET';
+        if (methodBadge?.dataset.method) {
+            method = methodBadge.dataset.method;
+        } else {
+            // Second try: try-out form data attribute
+            const tryOutForm = document.querySelector('.try-out-form');
+            if (tryOutForm?.dataset.method) {
+                method = tryOutForm.dataset.method.toUpperCase();
+            } else {
+                // Third try: method badge text content
+                if (methodBadge?.textContent) {
+                    method = methodBadge.textContent.trim();
+                }
+            }
+        }
 
         return {
             url: fullUrl,

drf_to_mkdoc/templates/er_diagrams/app.html

@@ -0,0 +1,26 @@
+# {{ app_name|title|cut:"_"|safe }} Models
+
+```mermaid
+erDiagram
+{% for entity in app_entities %}
+    {{ entity.model_name }} {
+{% for field in entity.fields %}
+        {{ field.name }} {{ field.type }}{% if field.is_pk %} "PK"{% elif field.nullable %} "NULLABLE"{% endif %}
+{% endfor %}
+    }
+{% endfor %}
+{% for entity in related_entities %}
+    {{ entity.model_name }} {
+        id AutoField "PK"
+    }
+{% endfor %}
+{% for relationship in relationships %}
+    {{ relationship.source_model }} {{ relationship.type }} {{ relationship.target_model }} : "{{ relationship.description }}"
+{% endfor %}
+
+```
+
+## Models
+
+{% for entity in app_entities %}- [{{ entity.model_name }}](../../models/{{ entity.app_name }}/{{ entity.table_name }}/)
+{% endfor %}

drf_to_mkdoc/templates/er_diagrams/index.html

@@ -0,0 +1,14 @@
+# Entity-Relationship Diagrams
+
+This section contains Entity-Relationship (ER) diagrams for all Django models in the system.
+
+## [Complete System Diagram](main.md)
+
+View the complete ER diagram showing all models and their relationships.
+
+## Application Diagrams
+
+| Application | Models 
+|------------|--------|
+{% for app in apps %}| [{{ app.name|title|cut:"_"|safe }}]({{ app.name }}.md) | {{ app.model_count }} |
+{% endfor %}

drf_to_mkdoc/templates/er_diagrams/main.html

@@ -0,0 +1,22 @@
+# Complete Entity-Relationship Diagram
+
+```mermaid
+erDiagram
+{% for entity in entities %}
+    {{ entity.model_name }} {
+{% for field in entity.fields %}
+        {{ field.name }} {{ field.type }}{% if field.is_pk %} "PK"{% elif field.nullable %} "NULLABLE"{% endif %}
+{% endfor %}
+    }
+{% endfor %}
+{% for relationship in relationships %}
+    {{ relationship.source_model }} {{ relationship.type }} {{ relationship.target_model }} : "{{ relationship.description }}"
+{% endfor %}
+
+```
+
+<div class="er-diagram-controls">
+  <button class="zoom-in">Zoom In</button>
+  <button class="zoom-out">Zoom Out</button>
+  <button class="reset-zoom">Reset</button>
+</div>

drf_to_mkdoc/utils/endpoint_detail_generator.py

@@ -742,7 +742,7 @@ def parse_endpoints_from_schema(paths: dict[str, Any]) -> dict[str, list[dict[st
 
     for path, methods in paths.items():
         app_name = extract_app_from_operation_id(next(iter(methods.values()))["operationId"])
-        if app_name not in django_apps:
+        if django_apps and app_name not in django_apps:
             continue
 
         for method, endpoint_data in methods.items():

drf_to_mkdoc/utils/er_diagram_generator.py

@@ -0,0 +1,230 @@
+from pathlib import Path
+from typing import Any
+
+from django.template.loader import render_to_string
+
+from drf_to_mkdoc.conf.settings import drf_to_mkdoc_settings
+
+from .commons.file_utils import write_file
+
+
+def _get_relationship_type_and_description(rel_type_class: str) -> tuple[str, str] | None:
+    """Map Django relationship type to Mermaid ER diagram syntax and description."""
+    mapping = {
+        "ForeignKey": ("}o--||", "many to 1"),
+        "OneToOneField": ("||--||", "1 to 1"),
+        "OneToOneRel": ("||--||", "1 to 1"),
+        "ManyToManyField": ("}o--o{", "many to many"),
+        "ManyToManyRel": ("}o--o{", "many to many"),
+        "ManyToOneRel": ("||--o{", "1 to many"),
+    }
+    return mapping.get(rel_type_class)
+
+
+def _create_entity_from_model(
+    app_name: str, model_name: str, model_info: dict[str, Any], include_fields: bool = False
+) -> dict[str, Any]:
+    """Create entity dictionary from model data, optionally including field details."""
+    table_name = model_info.get("table_name", model_name)
+    entity_id = f"{app_name}__{table_name}"
+
+    entity = {
+        "id": entity_id,
+        "app_name": app_name,
+        "model_name": model_name,
+        "table_name": table_name,
+        "fields": [],
+    }
+
+    if include_fields:
+        fields = []
+        has_pk = False
+
+        for field_name, field_info in model_info.get("column_fields", {}).items():
+            field_type = field_info.get("type", "")
+            is_pk = field_info.get("primary_key", False)
+            nullable = field_info.get("null", False) or field_info.get("blank", False)
+
+            fields.append({
+                "name": field_name,
+                "type": field_type,
+                "is_pk": is_pk,
+                "nullable": nullable
+            })
+
+            if is_pk:
+                has_pk = True
+
+        if not has_pk:
+            fields.insert(0, {
+                "name": "id",
+                "type": "AutoField",
+                "is_pk": True,
+                "nullable": False
+            })
+
+        entity["fields"] = fields
+
+    return entity
+
+
+def _process_model_relationships(
+    source_entity_id: str,
+    source_model_name: str,
+    model_info: dict[str, Any],
+    all_models_data: dict[str, Any]
+) -> list[dict[str, Any]]:
+    """Extract and process model relationships, returning Mermaid-compatible relationship data."""
+    relationships = []
+
+    for rel_name, rel_info in model_info.get("relationships", {}).items():
+        if not isinstance(rel_info, dict):
+            continue
+
+        related_model_label = rel_info.get("related_model", "")
+        if not related_model_label or "." not in related_model_label:
+            continue
+
+        target_app, target_model = related_model_label.split(".", 1)
+
+        target_table_name = rel_info.get("table_name", target_model.lower())
+        if target_app in all_models_data and target_model in all_models_data[target_app]:
+            target_table_name = all_models_data[target_app][target_model].get(
+                "table_name", target_model.lower()
+            )
+
+        target_entity_id = f"{target_app}__{target_table_name}"
+
+        rel_type_class = rel_info.get("type", "")
+        type_info = _get_relationship_type_and_description(rel_type_class)
+        if not type_info:
+            continue
+
+        rel_type, description = type_info
+
+        relationships.append({
+            "source": source_entity_id,
+            "target": target_entity_id,
+            "source_model": source_model_name,
+            "target_model": target_model,
+            "type": rel_type,
+            "label": rel_name,
+            "description": description,
+        })
+
+    return relationships
+
+
+def generate_er_diagrams(models_data: dict[str, Any], docs_dir: Path) -> None:
+    """Generate main ER diagram, app-specific diagrams, and index page from model data."""
+    generate_main_er_diagram(models_data, docs_dir)
+
+    for app_name, models in models_data.items():
+        if not isinstance(models, dict):
+            continue
+        generate_app_er_diagram(app_name, models, models_data, docs_dir)
+
+    generate_er_diagrams_index(models_data, docs_dir)
+
+
+def generate_main_er_diagram(models_data: dict[str, Any], _docs_dir: Path) -> None:
+    """Create main ER diagram showing all models and their relationships."""
+    entities = []
+    relationships = []
+
+    for app_name, models in models_data.items():
+        if not isinstance(models, dict):
+            continue
+
+        for model_name, model_info in models.items():
+            if not isinstance(model_info, dict):
+                continue
+
+            entity = _create_entity_from_model(app_name, model_name, model_info, include_fields=False)
+            entities.append(entity)
+
+            model_relationships = _process_model_relationships(
+                entity["id"], model_name, model_info, models_data
+            )
+            relationships.extend(model_relationships)
+
+    content = render_to_string(
+        "er_diagrams/main.html", {"entities": entities, "relationships": relationships}
+    )
+
+    write_file(f"{drf_to_mkdoc_settings.ER_DIAGRAMS_DIR}/main.md", content)
+
+
+def generate_app_er_diagram(
+    app_name: str, app_models: dict[str, Any], all_models_data: dict[str, Any], _docs_dir: Path
+) -> None:
+    """Create app-specific ER diagram with detailed fields and related models."""
+    app_entities = []
+    related_entities = []
+    relationships = []
+    related_entity_ids = set()
+
+    for model_name, model_info in app_models.items():
+        if not isinstance(model_info, dict):
+            continue
+
+        entity = _create_entity_from_model(app_name, model_name, model_info, include_fields=True)
+        app_entities.append(entity)
+
+        model_relationships = _process_model_relationships(
+            entity["id"], model_name, model_info, all_models_data
+        )
+
+        for relationship in model_relationships:
+            target_entity_id = relationship["target"]
+            target_model = relationship["target_model"]
+            target_app = target_entity_id.split("__")[0]
+
+            if target_app != app_name and target_entity_id not in related_entity_ids:
+                if target_app in all_models_data and target_model in all_models_data[target_app]:
+                    target_model_info = all_models_data[target_app][target_model]
+                    related_entity = _create_entity_from_model(
+                        target_app, target_model, target_model_info, include_fields=False
+                    )
+                    related_entities.append(related_entity)
+                    related_entity_ids.add(target_entity_id)
+
+            relationships.append(relationship)
+
+    content = render_to_string(
+        "er_diagrams/app.html",
+        {
+            "app_name": app_name,
+            "app_entities": app_entities,
+            "related_entities": related_entities,
+            "relationships": relationships,
+        },
+    )
+
+    write_file(f"{drf_to_mkdoc_settings.ER_DIAGRAMS_DIR}/{app_name}.md", content)
+
+
+def generate_er_diagrams_index(models_data: dict[str, Any], _docs_dir: Path) -> None:
+    """Create index page listing all available ER diagrams with app summaries."""
+    apps = []
+
+    for app_name in sorted(models_data.keys()):
+        if not isinstance(models_data[app_name], dict):
+            continue
+
+        model_count = len([
+            m for m in models_data[app_name]
+            if isinstance(models_data[app_name][m], dict)
+        ])
+
+        model_names = []
+        for model_name, model_info in models_data[app_name].items():
+            if isinstance(model_info, dict):
+                model_names.append(model_name)
+                if len(model_names) >= 3:
+                    break
+
+        apps.append({"name": app_name, "model_count": model_count})
+
+    content = render_to_string("er_diagrams/index.html", {"apps": apps})
+    write_file(f"{drf_to_mkdoc_settings.ER_DIAGRAMS_DIR}/index.md", content)

drf_to_mkdoc/utils/schema.py

@@ -2,7 +2,7 @@ import inspect
 import logging
 from importlib import import_module
 from types import SimpleNamespace
-from typing import Any
+from typing import Any, List
 
 from drf_spectacular.openapi import AutoSchema as SpectacularAutoSchema
 from drf_spectacular.plumbing import ComponentRegistry
@@ -208,6 +208,15 @@ class AutoSchema(SpectacularAutoSchema):
     directly to the operation during schema generation instead of using a postprocessing hook.
     """
 
+    def __init__(self, *args, **kwargs):
+        self.tags = kwargs.pop("tags", [])
+        super().__init__()
+
+    def get_tags(self) -> List[str]:
+        if self.tags:
+            return self.tags
+        return super().get_tags()
+
     def get_operation(
         self,
         path: str,

drf_to_mkdoc-0.3.1.dist-info/METADATA

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: drf-to-mkdoc
+Version: 0.3.1
+Summary: Generate Markdown API docs from Django/DRF OpenAPI schema for MkDocs
+Author-email: Hossein Shayesteh <shayestehhs1@gmail.com>
+Maintainer-email: Hossein Shayesteh <shayestehhs1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/shayestehhs/drf-to-mkdoc
+Project-URL: Repository, https://github.com/shayestehhs/drf-to-mkdoc
+Project-URL: Documentation, https://github.com/shayestehhs/drf-to-mkdoc#readme
+Project-URL: Bug Tracker, https://github.com/shayestehhs/drf-to-mkdoc/issues
+Keywords: django,django-rest-framework,documentation,mkdocs,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Topic :: Documentation
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django<6.0,>=3.2
+Requires-Dist: djangorestframework<4.0,>=3.12
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: drf-spectacular>=0.26.0
+Requires-Dist: mkdocs>=1.4.0
+Requires-Dist: mkdocs-material>=9.0.0
+Requires-Dist: coreapi>=2.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-django>=4.5.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# DRF to MkDocs
+
+Unlock effortless API documentation for your Django REST Framework project. Automatically generate beautiful, interactive, and maintainable docs that accelerate developer onboarding and streamline your team's workflow.
+
+---
+
+## Why DRF to MkDocs?
+
+`DRF to MkDocs` bridges the gap between your API's OpenAPI schema and user-friendly, maintainable documentation. It introspects your Django models and DRF views to automatically generate a polished, feature-rich documentation site that stays in sync with your codebase, empowering your team to build better APIs, faster.
+
+-   **Effortless Documentation**: Automate the entire process of generating and updating your API docs. Say goodbye to manual work and outdated information.
+-   **Accelerate Onboarding**: Provide new joiners with interactive, easy-to-navigate documentation. The "Try-it-out" feature and clear model relationships help them become productive from day one.
+-   **Deeply Integrated with DRF**: Leverages `drf-spectacular` for accurate schema generation, ensuring your documentation is a true reflection of your API.
+-   **Enhance Developer Experience**: Features like the interactive API console and in-depth model pages streamline development, testing, and debugging for the entire team.
+-   **Beautiful & Professional**: Built on MkDocs with the Material theme for a clean, modern, and responsive UI that you'll be proud to share.
+
+## Gallery
+
+<details>
+<summary>🚀 Interactive Endpoint List & Filtering</summary>
+<img width="1434" height="943" alt="List-EndPoint" src="https://github.com/user-attachments/assets/f886fc7f-afa0-4faa-b9c2-d6f754ca3597" />
+</details>
+
+<details>
+<summary>🔬 Detailed Endpoint View with "Try-it-out"</summary>
+<img width="958" height="887" alt="Detail-EndPoint" src="https://github.com/user-attachments/assets/9d9e3d4b-cb92-4ece-831e-aef45ceec768" />
+<img width="532" height="804" alt="Try-it-out" src="https://github.com/user-attachments/assets/0f483922-60c4-4f62-8fb4-bc7372e82a03" />
+</details>
+
+<details>
+<summary>📚 Rich Model Documentation</summary>
+<img width="906" height="885" alt="Model-fields" src="https://github.com/user-attachments/assets/a1ca369c-ad40-4b05-83ec-ceb1f80aab23" />
+<img width="848" height="886" alt="Model" src="https://github.com/user-attachments/assets/683d6d26-a8e4-4c05-8b5f-11a61a62cb0c" />
+</details>
+
+<details>
+<summary>📈 Entity-Relationship Diagrams</summary>
+<img width="953" height="606" alt="ER-Diagram" src="https://github.com/user-attachments/assets/3d0b1cb0-7ebf-4d4a-a181-1b7dbc9c6a01" />
+</details>
+
+## Key Features
+
+| Feature                          | Description                                                                                                                              |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| 🚀 **Interactive API Console**     | Test endpoints directly from the documentation with a "Try-it-out" feature, complete with a request builder and response viewer.         |
+| 🔍 **Advanced Filtering & Search** | Instantly find endpoints with multi-criteria filtering by app, method, path, and a real-time search.                                   |
+| 📚 **In-Depth Model Pages**        | Automatically generate detailed pages for each model, including fields, relationships, choices, and methods.                           |
+| 📊 **Entity-Relationship Diagrams** | Visualize model relationships with auto-generated, interactive ER diagrams for each app and for the entire project.                    |
+| 🎨 **Modern & Responsive UI**      | A beautiful and intuitive interface powered by MkDocs Material, featuring light/dark themes and full mobile support.                   |
+| 🔧 **Highly Customizable**         | Override templates, configure settings, and use custom functions to tailor the documentation to your project's specific needs.         |
+| ⚙️ **Simple Integration**         | Works seamlessly with existing DRF projects and `drf-spectacular` without requiring complex setup.                                     |
+| 🤖 **AI-Powered Enhancements**     | (Working on it...) Leverage AI to generate smarter examples and more descriptive documentation for your API.                                     |
+
+## Getting Started
+
+### 1. Installation
+
+```bash
+pip install drf-to-mkdoc
+```
+
+### 2. Configure Your Django Project
+
+In your `settings.py`:
+
+```python
+# settings.py
+
+INSTALLED_APPS = [
+    # ... your other apps
+    'drf_to_mkdoc',
+    'drf_spectacular',  # Required for schema generation
+]
+
+# Required for OpenAPI schema generation
+REST_FRAMEWORK = {
+    'DEFAULT_SCHEMA_CLASS': 'drf_to_mkdoc.utils.schema.AutoSchema',
+}
+
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'Your API',
+    'DESCRIPTION': 'Your API description',
+    'VERSION': '1.0.0',
+}
+
+# DRF to MkDocs specific settings
+DRF_TO_MKDOC = {
+    'DJANGO_APPS': [
+        'users',
+        'products',
+        # ... list all apps you want to document
+    ],
+}
+```
+
+### 3. Create MkDocs Configuration
+
+Create an `mkdocs.yml` file in your project root. You can start with the [default configuration](docs/mkdocs.yml) and customize it.
+
+### 4. Build Your Documentation
+
+```bash
+python manage.py build_docs
+```
+
+For more detailed instructions, see the full [Installation and Setup Guide](docs/installation.md).
+
+## Usage and Customization
+
+### Building Your Documentation
+
+To build the entire documentation site, run the following command. This will generate a static site in your `site/` directory.
+
+```bash
+python manage.py build_docs
+```
+
+For more granular control, `DRF to MkDocs` provides several commands, such as `build_endpoint_docs` and `build_model_docs`.
+
+### Serving Docs with Django
+
+You can serve your documentation directly from your Django application, protecting it with Django's authentication system. This is ideal for private or internal APIs.
+
+For a complete guide, see [Serving Docs with Django](docs/serving_docs_with_django.md).
+
+### Customizing the OpenAPI Schema
+
+`DRF to MkDocs` allows you to override and extend the auto-generated OpenAPI schema by providing a custom JSON file. This gives you fine-grained control over the final documentation, enabling you to add examples, descriptions, or even custom endpoints.
+
+For more details, refer to the [Customizing Endpoints](docs/customizing_endpoints.md) guide.
+
+### Best Practices
+
+For better project organization, we recommend creating a separate `docs_settings.py` for documentation-specific configurations and using the `--settings` flag:
+
+```bash
+python manage.py build_docs --settings=my_project.docs_settings
+```
+
+This keeps your production settings clean and your documentation configuration isolated.
+
+## Configuration
+
+You can customize the behavior of `DRF to MkDocs` by configuring the `DRF_TO_MKDOC` dictionary in your settings file.
+
+| Key                              | Description                                                                    | Default                               |
+| -------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------- |
+| `DJANGO_APPS` (required)         | A list of Django app names to process.                                         | `[]`                                  |
+| `DOCS_DIR`                       | The base directory where documentation will be generated.                      | `'docs'`                              |
+| `ER_DIAGRAMS_DIR`                | The directory for ER diagrams, relative to `DOCS_DIR`.                         | `'er_diagrams'`                       |
+| `FIELD_GENERATORS`               | Custom field value generators for creating better examples.                    | `{}`                                  |
+| `ENABLE_AI_DOCS`                 | A flag to enable AI-powered documentation features.                            | `False`                               |
+| `PATH_PARAM_SUBSTITUTE_FUNCTION` | A custom function for substituting path parameters in URLs.                    | `None`                                |
+| `PATH_PARAM_SUBSTITUTE_MAPPING`  | A mapping for substituting common path parameters (e.g., `{'pk': 1}`).        | `{}`                                  |
+
+## How It Works
+
+`DRF to MkDocs` operates in a few stages:
+
+1.  **Model Introspection**: It deeply analyzes your Django models, mapping out their fields, relationships (like ForeignKeys and ManyToManyFields), and metadata.
+2.  **Schema Generation**: It uses `drf-spectacular` to generate a detailed OpenAPI schema for your API endpoints.
+3.  **Template Rendering**: It renders Jinja2 templates for each endpoint, model, and ER diagram, creating Markdown files.
+4.  **MkDocs Build**: Finally, it invokes MkDocs to build a static HTML site from the generated Markdown files.
+
+This process ensures that your documentation is always an accurate and comprehensive reflection of your codebase.
+
+## Contributing
+
+Contributions are welcome! Whether it's a bug report, a new feature, or an improvement to the documentation, we appreciate your help. To ensure code quality, we use **CoderabbitAI** for automated code reviews on all pull requests.
+
+Please see our [Contributing Guidelines](CONTRIBUTING.md) to get started.
+
+### Development Setup
+
+```bash
+git clone https://github.com/Shayestehhs/drf-to-mkdoc.git
+cd drf-to-mkdoc
+pip install -e ".[dev]"
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

{drf_to_mkdoc-0.2.4.dist-info → drf_to_mkdoc-0.3.1.dist-info}/RECORD

@@ -1,13 +1,13 @@
 drf_to_mkdoc/__init__.py,sha256=IbTW5uKQvJRG9ncHRuk_AGKHPn4ruxs5LqDpUFgUhws,180
 drf_to_mkdoc/apps.py,sha256=-NrC_dRr6GmLmNQhkNh819B7V1SS4DYDv5JOR0TtuJM,560
 drf_to_mkdoc/conf/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-drf_to_mkdoc/conf/defaults.py,sha256=mE9c42NqWnEpR5hxhDSdDewgKbvqcU3v1DI0ge_xao0,1014
-drf_to_mkdoc/conf/settings.py,sha256=3f268CZzyf9KYab6EvsjIVXP6KBik1k_B4JyJpXDwrU,5456
+drf_to_mkdoc/conf/defaults.py,sha256=5qbjvHvhhkQChRdy3tJvGRoJ1uXzBfoiHf71kt3a3XI,1072
+drf_to_mkdoc/conf/settings.py,sha256=sxg3VIlhUkcxL1g-21E3FSuwqH4MfL9C3m2QwGw5rqA,5499
 drf_to_mkdoc/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drf_to_mkdoc/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drf_to_mkdoc/management/commands/build_docs.py,sha256=k2N8i7sNWPJGVzUSdkDu47FleCSjIxClRq1dWBHwhjQ,4057
 drf_to_mkdoc/management/commands/build_endpoint_docs.py,sha256=UcKoHFzmsEhs90kHMRvRe2XWx6xigrGAnwA5iEs839s,2450
-drf_to_mkdoc/management/commands/build_model_docs.py,sha256=8d7UjwwIsEsReIH4b93nTqFnrZO8kPHXdQaSTYudUGw,1926
+drf_to_mkdoc/management/commands/build_model_docs.py,sha256=xVrsDXBG5FXviGPwr0t8atc6MibUxHRNu2rT3jBgyco,2336
 drf_to_mkdoc/management/commands/extract_model_data.py,sha256=XoMO4C22ZPKQ99bh1WskEUT1JkA3GpDN5wb3_D5cN0I,13583
 drf_to_mkdoc/management/commands/generate_doc_json.py,sha256=mWdYgMbSeLP4iQZeUm2DxwYQmdGy8w05XTEfbT_nOJo,19833
 drf_to_mkdoc/management/commands/update_doc_schema.py,sha256=TtHVQxnVpB_VELRkVcdsDXDU5zXdguFleB1mXCDMAbg,2009
@@ -19,7 +19,7 @@ drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/form-manager.js,sha256=6KIe
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/main.js,sha256=W0Vv9jdCturToACs_wapZ37ux0nRXy1d3GqfXq-0NuI,1821
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/modal.js,sha256=IUg33Er2cF6qzIbxgnvlj8C_fSjNariyfFd3zswu3wU,14238
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/query-parameters-extractor.js,sha256=3b6XshRFdf5TeZNktgxEBenEFWTTEsKjYZll0xMUv3Q,3542
-drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/request-executor.js,sha256=CsIusYZ5RIJXQFN3eh3ZcTLgf6hoZJ7E9BP1_EGsSiA,11904
+drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/request-executor.js,sha256=lBKP-GbUyXKhIGS1q0V0GxeJueRHTjfaDorIgB-LClg,12565
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/response-modal.js,sha256=D8Xd9rEAJpMPExVxSmJ7PaQXCmIfRPhyv6t93A0AP0w,5671
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/suggestions.js,sha256=WOXppK1HgYFDbVkCvchBKxL8rc_974roJAxZE2EBdDo,4396
 drf_to_mkdoc/static/drf-to-mkdoc/javascripts/try-out/tabs.js,sha256=WwAjbisNap0lOQ3pZyWkW0G7hXvy_gFjHMCCPUu50a8,2791
@@ -71,6 +71,9 @@ drf_to_mkdoc/templates/endpoints/list/filters/app.html,sha256=vjY0GGg1UGKKb2JAIa
 drf_to_mkdoc/templates/endpoints/list/filters/method.html,sha256=B9WHuuScIF45QRGv1wZVocCKMPUvyuEDg_gMaE02NXc,410
 drf_to_mkdoc/templates/endpoints/list/filters/path.html,sha256=ZKq50BJu9AYdjiY2TXxhM8c8ivz6M8J_aZIC_q2gVvE,180
 drf_to_mkdoc/templates/endpoints/list/filters/search.html,sha256=NbndD69M-iwFf-BXMo7rsHh1lrZnf6hiZGkPtGF1hU4,280
+drf_to_mkdoc/templates/er_diagrams/app.html,sha256=4ptCVDrKKNMfW0mJbSQPYpe_wvJuNoRiL-uAg4uEYVc,749
+drf_to_mkdoc/templates/er_diagrams/index.html,sha256=KxIpF-Krbbs6fIDdx52AS84sMs7L_pRjlnYklKNrD6s,429
+drf_to_mkdoc/templates/er_diagrams/main.html,sha256=w0mA8Czb--B7FbQOyW6VCeGm1phMOzz2P9CAB4KK0po,657
 drf_to_mkdoc/templates/model_detail/base.html,sha256=uJaGnFwfv68uJgWJA85Svs7MXPQ-dXi3-SJgR9GfiNM,731
 drf_to_mkdoc/templates/model_detail/choices.html,sha256=-DAbUpr5jXL_e8r--KkdRXGZuF94_TuVmN17WQDltk0,304
 drf_to_mkdoc/templates/model_detail/fields.html,sha256=dOYhfwFJThAuG65r8i6_A9budCTNsZ1pQRCGgAKdFAc,1163
@@ -84,11 +87,12 @@ drf_to_mkdoc/templates/try-out/modal.html,sha256=G3Ye6DntMVVYUnmbwkrf-YcYmw7AxtC
 drf_to_mkdoc/templates/try-out/response-modal.html,sha256=mjt1bud07Y3BXp7716mQMlrv8xGRaQr4W2XRNKJWwGA,5980
 drf_to_mkdoc/templatetags/custom_filters.py,sha256=b_0ExGgBKUIlNkJ8nXlc6mrhhiUUxtdq9thXH-yzEq4,3761
 drf_to_mkdoc/utils/__init__.py,sha256=6dFTb07S6yIf-INMy0Mlgf5purNir687ZU9WZtITh4k,68
-drf_to_mkdoc/utils/endpoint_detail_generator.py,sha256=qYFM84KuiygNMNGQ_aiT6nxVexWtM8mZb3WfFrV8zVU,28375
+drf_to_mkdoc/utils/endpoint_detail_generator.py,sha256=toZ3JWlVHtsYPJLG8ZDvLYtfsbNr3P-YEINKpOElwQ4,28391
 drf_to_mkdoc/utils/endpoint_list_generator.py,sha256=yVX7qVUTuKF3TPFgm6FI-vVsVZQ7XHMXmZZalgSN8pk,3579
+drf_to_mkdoc/utils/er_diagram_generator.py,sha256=9X4L2XPVSKwxHZQspOSMg7TacAzImeXGgYPzhlsL-U8,7962
 drf_to_mkdoc/utils/model_detail_generator.py,sha256=_ac2PYSzSwRUgUn-J-nmg7mfQGn8SU_4vkMpMRIxgEU,2619
 drf_to_mkdoc/utils/model_list_generator.py,sha256=Ki-CwIYKmUbPm3_jUPLPosPfppyVLrZMkqbuPPO3Ycw,1988
-drf_to_mkdoc/utils/schema.py,sha256=sDhVITdIFp1TJYnqCd4wF69i-lwXGlTsNJ2-ngXkccc,10070
+drf_to_mkdoc/utils/schema.py,sha256=vVLnnVt3ANaHSAdrsjOEfkakZZufeR5PUSuo2dyR4vU,10311
 drf_to_mkdoc/utils/ai_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 drf_to_mkdoc/utils/ai_tools/enums.py,sha256=K39bJjHgXwNst2NL6z-5bztW3ZU5iCxg2b0KEodD6eM,238
 drf_to_mkdoc/utils/ai_tools/exceptions.py,sha256=yFauOtuSRGRnQt41u2qCMvWEbN0eblgKwXuH-GX3Wbk,634
@@ -105,8 +109,8 @@ drf_to_mkdoc/utils/commons/path_utils.py,sha256=Pi9g1xXDPsRzmn4kTeNSVtXG9v6n1h2Z
 drf_to_mkdoc/utils/commons/schema_utils.py,sha256=1mQxzo08J6tlVmTIJ0hCQ6wCZUWMuV82POhLWUfOYtI,7567
 drf_to_mkdoc/utils/extractors/__init__.py,sha256=BvC8gKOPVI9gU1Piw0jRhKQ2ER5s1moAxgq7ZYkJWNI,86
 drf_to_mkdoc/utils/extractors/query_parameter_extractors.py,sha256=xELPYI6tcqfkxOa475JPMaxRzRGUX--Z9oYRlKgXb7w,7964
-drf_to_mkdoc-0.2.4.dist-info/licenses/LICENSE,sha256=3n9_ckIREsH8ogCxWW6dFsw_WfGcluG2mHcgl9i_UU0,1068
-drf_to_mkdoc-0.2.4.dist-info/METADATA,sha256=utbuKPyj_A2eYjnpTln_O1CzjC-OPfzGcaxoZWz1ryY,10652
-drf_to_mkdoc-0.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-drf_to_mkdoc-0.2.4.dist-info/top_level.txt,sha256=ZzJecR6j_tvLZiubUBEgawHflozC4DQy9ooNf1yDJ3Q,13
-drf_to_mkdoc-0.2.4.dist-info/RECORD,,
+drf_to_mkdoc-0.3.1.dist-info/licenses/LICENSE,sha256=3n9_ckIREsH8ogCxWW6dFsw_WfGcluG2mHcgl9i_UU0,1068
+drf_to_mkdoc-0.3.1.dist-info/METADATA,sha256=vsGgQCWq3UUXiVIPrNo8DvyKkkFxXiolEVmtZNu2iwI,11692
+drf_to_mkdoc-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+drf_to_mkdoc-0.3.1.dist-info/top_level.txt,sha256=ZzJecR6j_tvLZiubUBEgawHflozC4DQy9ooNf1yDJ3Q,13
+drf_to_mkdoc-0.3.1.dist-info/RECORD,,

drf_to_mkdoc-0.2.4.dist-info/METADATA

@@ -1,295 +0,0 @@
-Metadata-Version: 2.4
-Name: drf-to-mkdoc
-Version: 0.2.4
-Summary: Generate Markdown API docs from Django/DRF OpenAPI schema for MkDocs
-Author-email: Hossein Shayesteh <shayestehhs1@gmail.com>
-Maintainer-email: Hossein Shayesteh <shayestehhs1@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/shayestehhs/drf-to-mkdoc
-Project-URL: Repository, https://github.com/shayestehhs/drf-to-mkdoc
-Project-URL: Documentation, https://github.com/shayestehhs/drf-to-mkdoc#readme
-Project-URL: Bug Tracker, https://github.com/shayestehhs/drf-to-mkdoc/issues
-Keywords: django,django-rest-framework,documentation,mkdocs,api
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Framework :: Django
-Classifier: Framework :: Django :: 3.2
-Classifier: Framework :: Django :: 4.0
-Classifier: Framework :: Django :: 4.1
-Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.0
-Classifier: Topic :: Documentation
-Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: Django<6.0,>=3.2
-Requires-Dist: djangorestframework<4.0,>=3.12
-Requires-Dist: PyYAML>=6.0
-Requires-Dist: drf-spectacular>=0.26.0
-Requires-Dist: mkdocs>=1.4.0
-Requires-Dist: mkdocs-material>=9.0.0
-Requires-Dist: coreapi>=2.3.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-django>=4.5.0; extra == "dev"
-Requires-Dist: black>=22.0.0; extra == "dev"
-Requires-Dist: isort>=5.10.0; extra == "dev"
-Requires-Dist: flake8>=5.0.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# DRF to MkDocs
-
-Generate beautiful, interactive Markdown API documentation from Django REST Framework OpenAPI schema for MkDocs.
-
-## Why you'll love it
-
-- **Zero-hassle docs**: Beautiful, always-in-sync API docs straight from your codebase
-- **Model deep dive**: Auto-generated model pages with fields, relationships, and choices
-- **Lightning-fast discovery**: Interactive endpoint index with powerful filters and search
-- **Try-it-out**: Interactive API testing directly in the documentation with request/response examples
-- **AI-powered**: Optional AI-generated documentation with custom field generators(Wait for it...)
-- **DRF-native**: Works with DRF Spectacular; no custom schema wiring needed
-- **MkDocs Material**: Looks great out of the box with the Material theme
-
-## Installation
-
-See the full installation guide in `docs/installation.md`.
-
-## Quick Start
-
-1. **Configure your Django project**:
-
-```python
-# settings.py
-INSTALLED_APPS = [
-    # ... your other apps
-    'drf_to_mkdoc',
-]
-
-# Required for OpenAPI schema generation
-REST_FRAMEWORK = {
-    'DEFAULT_SCHEMA_CLASS': 'drf_to_mkdoc.utils.schema.AutoSchema',
-}
-
-SPECTACULAR_SETTINGS = {
-    'TITLE': 'Your API',
-    'DESCRIPTION': 'Your API description',
-    'VERSION': '1.0.0',
-
-}
-
-DRF_TO_MKDOC = {
-    'DJANGO_APPS': [
-        'users',
-        'products',
-        'orders',
-        'inventory',
-    ],
-    # Optional: Override default paths
-    # 'DOCS_DIR': 'docs',
-    # 'CONFIG_DIR': 'docs/configs',
-    # 'MODEL_DOCS_FILE': 'docs/model-docs.json',
-    # 'DOC_CONFIG_FILE': 'docs/configs/doc_config.json',
-    # 'CUSTOM_SCHEMA_FILE': 'docs/configs/custom_schema.json',
-    # 'FIELD_GENERATORS': {
-    #     'email': 'faker.email',
-    #     'name': 'faker.name',
-    #     'created_at': 'datetime.now',
-    # },
-    # 'ENABLE_AI_DOCS': False,
-}
-```
-
-2. **Create MkDocs configuration**:  
-   Copy the [`docs/mkdocs.yml`](docs/mkdocs.yml) file to your project root and customize it as needed.
-
-3. **Build documentation**:
-
-```bash
-python manage.py build_docs --settings=docs_settings
-```
-
-### Configuration Options
-
-The `DRF_TO_MKDOC` setting supports several configuration options:
-
-- **`DJANGO_APPS`** (required): List of Django app names to process
-- **`DOCS_DIR`**: Directory where docs will be generated (default: `docs`)
-- **`CONFIG_DIR`**: Directory for configuration files (default: `docs/configs`)
-- **`FIELD_GENERATORS`**: Custom field value generators for better examples
-- **`ENABLE_AI_DOCS`**: Enable AI-powered documentation features (default: `False`)
-- **`PATH_PARAM_SUBSTITUTE_FUNCTION`**: Custom function for path parameter substitution
-- **`PATH_PARAM_SUBSTITUTE_MAPPING`**: Mapping for path parameter substitution
-
-## Available Commands
-
-- `build_docs`: Build the complete documentation site with MkDocs
-- `build_endpoint_docs`: Build endpoint documentation from OpenAPI schema
-- `build_model_docs`: Build model documentation from model JSON data
-- `extract_model_data`: Extract model data from Django model introspection and save as JSON
-- `generate_doc_json`: Generate JSON context for new API endpoints to be documented
-- `update_doc_schema`: Update the final schema by copying the documented schema
-
-## What you get
-
-See a detailed overview of generated files in `docs/structure.md` and a feature breakdown in `docs/features.md`.
-
-## Key Features
-
-### 🚀 Interactive API Testing (Try-Out)
-- **Live API testing**: Test endpoints directly from the documentation
-- **Request builder**: Interactive forms for parameters, headers, and request body
-- **Response viewer**: Real-time response display with syntax highlighting
-- **Floating action button**: Easy access to testing interface
-- **Multiple examples**: Support for both empty and populated response examples
-
-### 🤖 AI-Powered Documentation
-- **Custom field generators**: Define custom value generators for specific fields
-- **AI documentation**: Optional AI-generated documentation with context analysis
-- **Smart examples**: Enhanced example generation for better API understanding
-
-### 📊 Advanced Filtering & Search
-- **Multi-criteria filtering**: Filter by app, HTTP method, path, and search terms
-- **Real-time search**: Instant search across all endpoints
-- **Smart suggestions**: Auto-complete for query parameters and field names
-
-### 🎨 Beautiful UI
-- **Material Design**: Modern, responsive interface with dark/light themes
-- **Interactive elements**: Hover effects, animations, and smooth transitions
-- **Mobile-friendly**: Fully responsive design for all devices
-
-## How it works
-
-Under the hood, drf-to-mkdoc introspects your models and reads your DRF OpenAPI schema to generate clean, organized Markdown. Then MkDocs turns it into a polished static site. Always current, no manual updates.
-
-## Explore more
-
-- Customizing endpoint docs: `docs/customizing_endpoints.md`
-- Serving docs through Django (with permissions): `docs/serving_mkdocs_with_django.md`
-
-## Dependencies
-
-- Django >= 3.2, < 6.0
-- Django REST Framework >= 3.12, < 4.0
-- drf-spectacular >= 0.26.0
-- PyYAML >= 6.0
-- MkDocs >= 1.4.0
-- MkDocs Material >= 9.0.0
-- coreapi >= 2.3.0
-
-## Development
-
-### Setup Development Environment
-
-```bash
-git clone https://github.com/Shayestehhs/drf-to-mkdoc.git
-cd drf-to-mkdoc
-pip install -e ".[dev]"
-```
-
-## Project Structure
-
-```
-drf-to-mkdoc/
-├── drf_to_mkdoc/
-│   ├── conf/
-│   │   ├── defaults.py      # Default configuration values
-│   │   └── settings.py      # Settings management
-│   ├── management/
-│   │   └── commands/
-│   │       ├── build_docs.py           # Build MkDocs site
-│   │       ├── build_endpoint_docs.py  # Build endpoint documentation
-│   │       ├── build_model_docs.py     # Build model documentation
-│   │       ├── extract_model_data.py   # Extract model data from Django
-│   │       ├── generate_doc_json.py    # Generate JSON context for AI docs
-│   │       └── update_doc_schema.py    # Schema updates
-│   ├── static/
-│   │   └── drf-to-mkdoc/
-│   │       ├── javascripts/
-│   │       │   ├── try-out/            # Interactive API testing
-│   │       │   └── endpoints-filter.js # Endpoint filtering
-│   │       └── stylesheets/            # CSS for styling
-│   ├── templates/
-│   │   ├── endpoints/                  # Endpoint documentation templates
-│   │   ├── model_detail/               # Model documentation templates
-│   │   └── try-out/                    # Interactive testing templates
-│   └── utils/
-│       ├── ai_tools/                   # AI-powered documentation features
-│       ├── commons/                    # Shared utilities
-│       ├── extractors/                 # Query parameter extraction
-│       ├── endpoint_detail_generator.py
-│       ├── endpoint_list_generator.py
-│       ├── model_detail_generator.py
-│       ├── model_list_generator.py
-│       └── schema.py
-├── docs/                      # Generated documentation
-├── pyproject.toml            # Project configuration
-└── README.md
-```
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Recommendations
-
-### .gitignore Configuration
-
-To avoid committing generated files to your repository, add the following to your `.gitignore` file:
-
-```gitignore
-# Documentation
-/docs/endpoints/
-/docs/models/
-/docs/configs/doc-schema.yaml
-
-# Build artifacts
-/site/
-```
-
-This will ensure that only the source configuration and scripts are versioned, while the generated documentation is excluded.
-
-### docs_settings.py Best Practices
-
-Create a separate `docs_settings.py` file that inherits from your main settings:
-
-```python
-# docs_settings.py
-from .settings import *
-
-DRF_TO_MKDOC = {
-    'DJANGO_APPS': ['your_app1', 'your_app2'],
-}
-# Other doc settings...
-```
-
-Then use the `--settings` argument when running the build command:
-
-```bash
-python manage.py build_docs --settings=docs_settings
-```
-
-### Project Organization
-
-```
-your-project/
-├── settings.py          # Main Django settings
-├── docs_settings.py     # Documentation-specific settings
-├── mkdocs.yml          # MkDocs configuration
-├── docs/               # Generated documentation (gitignored)
-└── site/               # Built site (gitignored)
-```
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed contribution guidelines.