Add comprehensive documentation with Documenter.jl

[ChrisRackauckas-Claude]

Summary

This PR adds a complete documentation infrastructure for DiffEqBase.jl using Documenter.jl, including enhanced docstrings and comprehensive interface documentation.

Changes Made

📚 Documentation Infrastructure

• Set up Documenter.jl with proper configuration and deployment
• Created comprehensive documentation pages for all interfaces
• Added GitHub Actions workflow for automatic documentation building

📝 Enhanced Docstrings

• Type Documentation:

  • Tableau and ODERKTableau: Detailed documentation for Butcher tableau types
  • DECostFunction: Documentation for cost function abstract type
  • AbstractParameterizedFunction: Enhanced documentation with usage examples
  • ConvergenceSetup: Complete documentation with fields and examples

• Algorithm Documentation:

  • SensitivityADPassThrough: Comprehensive documentation with usage, performance notes, and examples

• Enum Documentation:

  • KeywordArgError, KeywordArgWarn, KeywordArgSilent: Clear documentation for keyword argument handling

📖 Documentation Pages

API Reference

• Callbacks (api/callbacks.md): Documentation for initialization and finalization methods
• Integrator Interface (api/integrator.md): Low-level integrator control documentation
• Statistics (api/statistics.md): Statistical analysis utilities
• Utilities (api/utilities.md): General utility functions
• Tableaus (api/tableaus.md): Runge-Kutta tableau documentation
• Internal Functions (api/internal.md): Internal API documentation

Interface Guides

• Problem Interface (interfaces/problems.md): Guide for working with problem types
• Solution Interface (interfaces/solutions.md): Comprehensive solution interface documentation
• Algorithm Interface (interfaces/algorithms.md): Algorithm types and properties
• Function Interface (interfaces/functions.md): Detailed function interface with examples for ODEs, SDEs, DDEs, and DAEs

🔧 CI/CD

• Added .github/workflows/Documentation.yml for automatic documentation deployment
• Documentation will be built on every push to master and for all PRs

Benefits

1. Improved Developer Experience: Clear documentation makes it easier for new contributors and users to understand the codebase
2. Better API Discovery: Comprehensive API reference helps users find and use the right functions
3. Reduced Support Burden: Good documentation reduces the number of basic usage questions
4. Maintainability: Documented interfaces make it easier to maintain backward compatibility

Testing

• Documentation builds successfully locally
• All existing tests pass
• Formatted with JuliaFormatter using SciMLStyle

Next Steps

After this PR is merged:

1. Documentation will be automatically deployed to GitHub Pages
2. Consider adding more examples and tutorials in future PRs
3. Link to the documentation from the main README

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]