docs: auto-discover Python API modules and drive C API from YAML config

Python API: replace hardcoded file paths with PAGE_SOURCES config — each
entry lists directories to scan non-recursively. New .py files added to a
configured directory appear in the docs automatically without editing the
script.

C API: replace RST parser with fern/c_api_config.yaml for section
organization. Doxygen XML is still the symbol source; the YAML controls
section groupings and prose. Symbols not in the config auto-appear in
an "Uncategorized" section on the designated catchall page so new header
additions are never silently dropped. Added previously uncategorized
symbols (hyper diving/heuristic params, scaling constants, presolve
constants, deprecated quad create functions).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: ramakrishnap-nv

fern/c_api_config.yaml

@@ -2,13 +2,11 @@
 title: "cuOpt MIP C API Reference"
 ---
 
-This section contains the cuOpt MIP C API reference. Functions for problem creation, solver settings, solving, and inspecting solutions are shared with convex optimization and documented in [Convex C Api](convex-c-api).
+This section contains the cuOpt MIP C API reference. Functions for problem creation, solver settings, solving, and inspecting solutions are shared with convex optimization and documented in [Convex C API](../convex/convex-c-api).
 
 ## Warm Start and MIP Start
 
-For LP problems solved with PDLP, see [Convex C Api](convex-c-api) for primal and dual warm start.
-
-For MIP problems, one or more primal solution hints (MIP starts) may be provided:
+For LP problems solved with PDLP, see [Convex C API](../convex/convex-c-api) for primal and dual warm start. For MIP problems, one or more primal solution hints (MIP starts) may be provided.
 
 <hr />
 
@@ -100,7 +98,7 @@ Registering a set-solution callback disables presolve. The callback arguments re
 
 ## MIP Parameter Constants
 
-These constants configure MIP-specific solver behavior. Use them with `cuOptSetParameter`, `cuOptSetIntegerParameter`, or `cuOptSetFloatParameter`. For shared parameters (time limit, logging, presolve, etc.), see parameter-constants in the convex API reference.
+These constants configure MIP-specific solver behavior. Use them with `cuOptSetParameter`, `cuOptSetIntegerParameter`, or `cuOptSetFloatParameter`. For shared parameters (time limit, logging, presolve, etc.), see [Parameter Constants](../convex/convex-c-api#parameter-constants) in the convex API reference.
 
 - `CUOPT_NODE_LIMIT` (`"node_limit"`)
 - `CUOPT_WORK_LIMIT` (`"work_limit"`)
@@ -136,9 +134,55 @@ These constants configure MIP-specific solver behavior. Use them with `cuOptSetP
 - `CUOPT_MIP_STRONG_BRANCHING_SIMPLEX_ITERATION_LIMIT` (`"mip_strong_branching_simplex_iteration_limit"`)
 - `CUOPT_MIP_SEMICONTINUOUS_BIG_M` (`"mip_semi_continuous_big_m"`)
 
+## MIP Scaling Constants
+
+These constants are used to configure `CUOPT_MIP_SCALING` via `cuOptSetIntegerParameter`.
+
+- `CUOPT_MIP_SCALING_OFF` (`0`)
+- `CUOPT_MIP_SCALING_ON` (`1`)
+- `CUOPT_MIP_SCALING_NO_OBJECTIVE` (`2`)
+
 ## MIP Determinism Mode Constants
 
 These constants are used to configure `CUOPT_MIP_DETERMINISM_MODE` via `cuOptSetIntegerParameter`.
 
 - `CUOPT_MODE_OPPORTUNISTIC` (`0`)
 - `CUOPT_MODE_DETERMINISTIC` (`1`)
+
+## MIP Hyper Diving Parameters
+
+These constants configure the hyper diving heuristic. Use them with `cuOptSetParameter`, `cuOptSetIntegerParameter`, or `cuOptSetFloatParameter`.
+
+- `CUOPT_MIP_HYPER_DIVING_BACKTRACK_LIMIT` (`"mip_hyper_diving_backtrack_limit"`)
+- `CUOPT_MIP_HYPER_DIVING_COEFFICIENT` (`"mip_hyper_diving_coefficient"`)
+- `CUOPT_MIP_HYPER_DIVING_FARKAS` (`"mip_hyper_diving_farkas"`)
+- `CUOPT_MIP_HYPER_DIVING_GUIDED` (`"mip_hyper_diving_guided"`)
+- `CUOPT_MIP_HYPER_DIVING_ITERATION_LIMIT_FACTOR` (`"mip_hyper_diving_iteration_limit_factor"`)
+- `CUOPT_MIP_HYPER_DIVING_LINE_SEARCH` (`"mip_hyper_diving_line_search"`)
+- `CUOPT_MIP_HYPER_DIVING_MIN_NODE_DEPTH` (`"mip_hyper_diving_min_node_depth"`)
+- `CUOPT_MIP_HYPER_DIVING_NODE_LIMIT` (`"mip_hyper_diving_node_limit"`)
+- `CUOPT_MIP_HYPER_DIVING_PSEUDOCOST` (`"mip_hyper_diving_pseudocost"`)
+- `CUOPT_MIP_HYPER_DIVING_SHOW_TYPE` (`"mip_hyper_diving_show_type"`)
+- `CUOPT_MIP_HYPER_DIVING_VECTOR_LENGTH` (`"mip_hyper_diving_vector_length"`)
+
+## MIP Hyper Heuristic Parameters
+
+These constants configure the hyper heuristic solver. Use them with `cuOptSetParameter`, `cuOptSetIntegerParameter`, or `cuOptSetFloatParameter`.
+
+- `CUOPT_MIP_HYPER_HEURISTIC_CYCLE_DETECTION_LENGTH` (`"mip_hyper_heuristic_cycle_detection_length"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_ENABLED_RECOMBINERS` (`"mip_hyper_heuristic_enabled_recombiners"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_INITIAL_INFEASIBILITY_WEIGHT` (`"mip_hyper_heuristic_initial_infeasibility_weight"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_MAX_ITERS_WITHOUT_IMPROVEMENT` (`"mip_hyper_heuristic_max_iterations_without_improvement"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_NUM_CPUFJ_THREADS` (`"mip_hyper_heuristic_num_cpufj_threads"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_N_OF_MINIMUMS_FOR_EXIT` (`"mip_hyper_heuristic_n_of_minimums_for_exit"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_POPULATION_SIZE` (`"mip_hyper_heuristic_population_size"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_PRESOLVE_MAX_TIME` (`"mip_hyper_heuristic_presolve_max_time"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_PRESOLVE_TIME_RATIO` (`"mip_hyper_heuristic_presolve_time_ratio"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_RELATED_VARS_TIME_LIMIT` (`"mip_hyper_heuristic_related_vars_time_limit"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_RELAXED_LP_TIME_LIMIT` (`"mip_hyper_heuristic_relaxed_lp_time_limit"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_RINS_FIX_RATE` (`"mip_hyper_heuristic_rins_fix_rate"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_RINS_MAX_TIME_LIMIT` (`"mip_hyper_heuristic_rins_max_time_limit"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_RINS_TIME_LIMIT` (`"mip_hyper_heuristic_rins_time_limit"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_ROOT_LP_MAX_TIME` (`"mip_hyper_heuristic_root_lp_max_time"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_ROOT_LP_TIME_RATIO` (`"mip_hyper_heuristic_root_lp_time_ratio"`)
+- `CUOPT_MIP_HYPER_HEURISTIC_STAGNATION_TRIGGER` (`"mip_hyper_heuristic_stagnation_trigger"`)

fern/docs/pages/cuopt-c/convex/convex-c-api.mdx

@@ -3,7 +3,14 @@ title: "Convex Optimization Python API Reference"
 ---
 
 
-## Problem & Variables
+## Problem
+
+<hr />
+
+### class `VType`
+
+The type of a variable is continuous, integer, or semi-continuous. Variable Types can be directly used as a constant. CONTINUOUS is  VType.CONTINUOUS INTEGER is VType.INTEGER SEMI_CONTINUOUS is VType.SEMI_CONTINUOUS
+
 
 <hr />
 
@@ -844,15 +851,7 @@ Optimizes the LP or MIP problem with the added variables, constraints and object
 
 
 
-## Solver Settings
-
-LP/MIP solver settings package; implementation is in the ``solver_settings`` extension.
-
-Public ``solver_params`` is an immutable tuple so callers cannot mutate the extension module's internal parameter-name list used for validation.
-
-
-
-## I/O
+## Parser
 
 <hr />
 

fern/docs/pages/cuopt-c/mip/mip-c-api.mdx

@@ -2,4 +2,4 @@
 title: "MIP Python API Reference"
 ---
 
-<Note>MIP Python API shares classes with the LP API. See [Convex Optimization API](convex-api).</Note>
+<Note>No public API symbols found in the configured source directories.</Note>