Merge pull request #1214 from ChrisRackauckas-Claude/add-init-docstrings

Add comprehensive docstrings for all DAE initialization algorithms

Author: ChrisRackauckas

src/dae_initialization.jl

@@ -1,7 +1,11 @@
 # DAE Initialization Algorithms
 # The base types are in SciMLBase, we just add the specific algorithms here
 
-import SciMLBase: DAEInitializationAlgorithm, initialize_dae!
+import SciMLBase: DAEInitializationAlgorithm, initialize_dae!, CheckInit, NoInit, OverrideInit
+
+# Re-export the SciMLBase initialization algorithms for convenience
+# Note: Docstrings for these types should be added in SciMLBase where they are defined
+export CheckInit, NoInit, OverrideInit
 
 """
     struct DefaultInit <: DAEInitializationAlgorithm

src/solve.jl

@@ -439,6 +439,7 @@ explanations of the timestepping algorithms, see the
   - `DefaultInit()` (default): Automatically chooses the best initialization algorithm
   - `CheckInit()`: Only checks that initial conditions are consistent, errors if not
   - `NoInit()`: Skip initialization completely (for when you know conditions are consistent)
+  - `OverrideInit()`: Use problem's initialization_data (typically from ModelingToolkit)
   - `BrownBasicInit()`: Brown's basic initialization algorithm for index-1 DAEs
   - `ShampineCollocationInit()`: Shampine's collocation initialization for general DAEs
   See the [DAE initialization documentation](https://docs.sciml.ai/DiffEqDocs/stable/features/dae_initialization/)