Improve auto-generated API documentation formatting and navigation structure

[Copilot]

This PR dramatically improves the auto-generated API documentation pages by implementing better formatting, hierarchical navigation, and visual styling inspired by Microsoft's documentation standards.

Problem

The current auto-generated documentation pages were poorly formatted and difficult to navigate:

• All method headings were at the same level (h4), creating a flat, confusing structure
• No clear visual distinction between classes, methods, parameters, and return values
• Missing hierarchical table of contents for easy browsing
• Poor readability with minimal visual hierarchy
• Limited navigation options within API documentation pages

Solution

Enhanced pydoc-markdown Configuration

• Improved signature formatting with proper code blocks and type hints
• Better table of contents generation with hierarchical structure
• Enhanced method signature display in headers with full type information
• Improved anchor and cross-reference handling

Comprehensive CSS Styling

• Enhanced visual hierarchy with proper spacing and borders between methods
• Styled class headings with colored backgrounds for better distinction
• Improved code block appearance with syntax highlighting
• Color-coded parameters and return value formatting
• Professional table of contents styling with proper nesting
• Responsive design improvements for better readability across devices

Hierarchical Navigation Structure

• Auto-generated table of contents showing all classes and methods with proper indentation
• Clear visual distinction between class names and method names
• Proper linking and anchor navigation throughout documentation
• Consistent improvements across all API documentation modules (AssemblyLine, ALToolbox, FormFyxer, etc.)

Result

The API documentation now provides clear hierarchical navigation similar to Microsoft's documentation standards, making it significantly easier for developers to browse through classes, methods, parameters, and return values.

Key improvements:

• Hierarchical Table of Contents: Auto-generated TOC with proper nesting showing all classes and methods
• Enhanced Visual Hierarchy: Class headings use colored backgrounds, methods have clear spacing and borders
• Better Code Formatting: Method signatures in proper code blocks with syntax highlighting and type hints
• Professional Styling: Color-coded parameters, enhanced spacing, and Microsoft-documentation-inspired layout
• Cross-Module Consistency: Improvements work uniformly across all auto-generated documentation modules

The auto-generated API documentation is now professional, well-organized, and significantly more navigable than the previous flat structure.

Fixes #543.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[nonprofittechy]

Made several fixes to CoPilot's attempt at this, and now I think this actually is in good shape: