feat: Disable GitHub Pages documentation, enable local-only builds

- Disable docs.yml and deploy-docs.yml workflows
- Update README with local documentation instructions
- Remove Documentation URL from pyproject.toml
- Add .nojekyll file to prevent accidental GitHub Pages processing
- Update documentation badge to reflect local build

Documentation is now built locally using 'mkdocs serve' only.

Author: fer

.github/workflows/deploy-docs.yml

@@ -1,17 +1,20 @@
-name: Deploy Documentation to GitHub Pages
+name: Deploy Documentation to GitHub Pages (DISABLED)
 
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'docs/**'
-      - 'mkdocs.yml'
-      - '.github/workflows/deploy-docs.yml'
-      - 'README.md'
-      - 'src/**/README.md'
-      - '*.md'
-  workflow_dispatch:
+# DISABLED: Documentation now built locally only
+# To re-enable, remove this comment and uncomment the 'on' section below
+
+# on:
+#   push:
+#     branches:
+#       - main
+#     paths:
+#       - 'docs/**'
+#       - 'mkdocs.yml'
+#       - '.github/workflows/deploy-docs.yml'
+#       - 'README.md'
+#       - 'src/**/README.md'
+#       - '*.md'
+# workflow_dispatch:
 
 permissions:
   contents: write

.github/workflows/docs.yml

@@ -1,16 +1,19 @@
-name: Build and Deploy Documentation
+name: Build and Deploy Documentation (DISABLED)
 
-on:
-  push:
-    branches: [ main ]
-  workflow_dispatch: {}
-  pull_request:
-    paths:
-      - 'mkdocs.yml'
-      - 'docs/**'
-      - 'README.md'
-      - 'src/**/README.md'
-      - '*.md'
+# DISABLED: Documentation now built locally only
+# To re-enable, remove this comment and uncomment the 'on' section below
+
+# on:
+#   push:
+#     branches: [ main ]
+#   workflow_dispatch: {}
+#   pull_request:
+#     paths:
+#       - 'mkdocs.yml'
+#       - 'docs/**'
+#       - 'README.md'
+#       - 'src/**/README.md'
+#       - '*.md'
 
 jobs:
   build-deploy:

README.md

@@ -8,7 +8,7 @@
 [![PyPI](https://img.shields.io/pypi/v/tnfr)](https://pypi.org/project/tnfr/)
 [![Python](https://img.shields.io/pypi/pyversions/tnfr)](https://pypi.org/project/tnfr/)
 [![License](https://img.shields.io/github/license/fermga/TNFR-Python-Engine)](https://github.com/fermga/TNFR-Python-Engine/blob/main/LICENSE.md)
-[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://fermga.github.io/TNFR-Python-Engine/)
+[![Documentation](https://img.shields.io/badge/docs-local%20build-brightgreen)](#-documentation)
 
 **🎓 Academic Citation**: [DOI: 10.5281/zenodo.17602861](https://doi.org/10.5281/zenodo.17602861)
 
@@ -41,6 +41,23 @@ If you use TNFR-Python-Engine in your research, please cite:
 **DOI**: [10.5281/zenodo.17602861](https://doi.org/10.5281/zenodo.17602861)  
 **Author ORCID**: [0009-0007-6116-0613](https://orcid.org/0009-0007-6116-0613)
 
+## 📖 Documentation
+
+Documentation is built locally using MkDocs. To build and serve the documentation:
+
+```bash
+# Install documentation dependencies
+pip install -e ".[docs]"
+
+# Build and serve locally (auto-reload on changes)
+mkdocs serve
+
+# Build static documentation
+mkdocs build  # Output in site/
+```
+
+The documentation will be available at `http://localhost:8000`
+
 ### Minimal Example
 ```python
 from tnfr.sdk import TNFRNetwork

docs/.nojekyll

@@ -0,0 +1,6 @@
+# This file prevents GitHub Pages from processing the site with Jekyll
+# Documentation is now built locally only using MkDocs
+# 
+# To build documentation locally:
+# 1. pip install -e ".[docs]"  
+# 2. mkdocs serve

pyproject.toml

@@ -171,7 +171,6 @@ PyPI = "https://pypi.org/project/tnfr/"
 Citation = "https://doi.org/10.5281/zenodo.17602861"
 Zenodo = "https://zenodo.org/records/17602861"
 Issues = "https://github.com/fermga/TNFR-Python-Engine/issues"
-Documentation = "https://fermga.github.io/TNFR-Python-Engine/"
 GPT = "https://chatgpt.com/g/g-67abc78885a88191b2d67f94fd60dc97-tnfr-resonant-fractal-nature-theory"
 
 [tool.setuptools.package-data]