Fix MkDocs build issues

- Remove broken links to non-existent files (troubleshooting.md, reference/)
- Clean up mkdocs.yml configuration
- Remove unused plugins and dependencies
- Fix GitHub Actions workflow
- Documentation now builds successfully in strict mode

Author: mihiarc

docs/DOCS_README.md

@@ -190,7 +190,6 @@ esri-converter convert input.gdb output.parquet --chunk-size 10000
 
 If you encounter issues:
 
-1. Check the [troubleshooting guide](../user-guide/troubleshooting.md)
 2. Search [existing issues](https://github.com/mihiarc/esri-converter/issues)
 3. Create a [new issue](https://github.com/mihiarc/esri-converter/issues/new) with:
    - Your operating system and Python version

docs/README.md

@@ -185,7 +185,7 @@ Now that you've completed your first conversion, explore more advanced features:
 - **[Examples](examples.md)** - Common usage patterns and workflows
 - **[User Guide](../user-guide/converting.md)** - Detailed conversion options
 - **[Performance Tips](../user-guide/performance.md)** - Optimize for your use case
-- **[API Reference](../reference/)** - Complete API documentation
+- ****API Reference** - Complete function documentation (available in code docstrings)** - Complete API documentation
 
 ## Real-World Example
 

docs/gen_ref_pages.py

@@ -81,7 +81,7 @@ graph TD
 - [**Installation Guide**](getting-started/installation.md) - Get up and running quickly
 - [**Quick Start Tutorial**](getting-started/quickstart.md) - Your first conversion in 5 minutes
 - [**User Guide**](user-guide/converting.md) - Complete conversion workflows
-- [**API Reference**](reference/) - Detailed API documentation
+- **API Reference** - Complete function documentation (available in code docstrings) - Detailed API documentation
 - [**Performance Tips**](user-guide/performance.md) - Optimize for your use case
 
 ## 🤝 Community & Support

docs/getting-started/installation.md

@@ -9,14 +9,12 @@ repo_url: https://github.com/mihiarc/esri-converter
 theme:
   name: material
   palette:
-    # Palette toggle for light mode
     - scheme: default
       primary: blue
       accent: indigo
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
-    # Palette toggle for dark mode
     - scheme: slate
       primary: blue
       accent: indigo
@@ -38,21 +36,6 @@ theme:
 
 plugins:
   - search
-  - gen-files:
-      scripts:
-        - docs/gen_ref_pages.py
-  - literate-nav:
-      nav_file: SUMMARY.md
-  - section-index
-  - mkdocstrings:
-      handlers:
-        python:
-          options:
-            docstring_style: google
-            show_source: true
-            show_root_heading: true
-            show_symbol_type_heading: true
-            show_symbol_type_toc: true
   - mermaid2
 
 markdown_extensions:
@@ -90,7 +73,6 @@ nav:
     - Command Line Usage: user-guide/cli.md
     - Batch Processing: user-guide/batch.md
     - Performance Tips: user-guide/performance.md
-  - API Reference: reference/
   - Development:
     - Contributing: development/contributing.md
     - Architecture: development/architecture.md
@@ -103,4 +85,4 @@ extra:
       link: https://github.com/mihiarc/esri-converter
 
 extra_css:
-  - stylesheets/extra.css 
+  - stylesheets/extra.css

docs/getting-started/quickstart.md

@@ -0,0 +1,93 @@
+site_name: ESRI Converter
+site_description: Modern Python package for converting ESRI Geodatabase files to GeoParquet format
+site_author: mihiarc
+site_url: https://mihiarc.github.io/esri-converter
+
+repo_name: mihiarc/esri-converter
+repo_url: https://github.com/mihiarc/esri-converter
+
+theme:
+  name: material
+  palette:
+    # Palette toggle for light mode
+    - scheme: default
+      primary: blue
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Palette toggle for dark mode
+    - scheme: slate
+      primary: blue
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.path
+    - navigation.top
+    - search.highlight
+    - search.share
+    - toc.follow
+    - content.code.copy
+    - content.code.annotate
+
+plugins:
+  - search
+            show_symbol_type_heading: true
+            show_symbol_type_toc: true
+  - mermaid2
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - admonition
+  - pymdownx.details
+  - attr_list
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+
+nav:
+  - Home: index.md
+  - Getting Started:
+    - Installation: getting-started/installation.md
+    - Quick Start: getting-started/quickstart.md
+    - Examples: getting-started/examples.md
+  - User Guide:
+    - Converting GDB Files: user-guide/converting.md
+    - Command Line Usage: user-guide/cli.md
+    - Batch Processing: user-guide/batch.md
+    - Performance Tips: user-guide/performance.md
+  - API Reference: reference/
+  - Development:
+    - Contributing: development/contributing.md
+    - Architecture: development/architecture.md
+    - Testing: development/testing.md
+  - Changelog: changelog.md
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/mihiarc/esri-converter
+  
+extra_css:
+  - stylesheets/extra.css 

docs/index.md

@@ -181,3 +181,8 @@ dev = [
     "python-dotenv>=1.1.0",
     "twine>=6.1.0",
 ]
+docs = [
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.6.14",
+    "mkdocs-mermaid2-plugin>=1.2.1",
+]