linter fixes

components/data_comps/docs/index.md

@@ -8,6 +8,6 @@ The E3SM data models are key components to support many different scenarios:
 
 More details can be found for each component below.
 
-- [Data Atmosphere](user-guide/data-atmos-main.md)
-- [Data Land](user-guide/data-land-main.md)
-- [Data Ocean](user-guide/data-ocean-main.md)
+- [Data Atmosphere](user-guide/data-atmos.md)
+- [Data Land](user-guide/data-land.md)
+- [Data Ocean](user-guide/data-ocean.md)

components/data_comps/docs/user-guide/data-ocean.md

@@ -1,15 +1,18 @@
 # The E3SM Data Ocean Model
 
+<!-- disable certain linter checks here for more readable nested markdown  -->
+<!-- markdownlint-disable  MD007 --> <!-- ul-indent -->
+
 The E3SM data ocean has several different modes to support various realistic and idealized experiments. Sea surface temperatures (SST) can be either prescribed or prognostic. Prescribed SSTs are specified either through a data stream or analytically. Prognostic modes allow the SST field to evolve and respond to atmospheric conditions. The guides below provide more details on how to use these capabilities.
 
 - Prescribed
-    - [SST from Observations](#sst-from-observations)
-    - [Idealized SST](#idealized-sst)
+    - [SST from Observations](##sst-from-observations)
+    - [Idealized SST](##idealized-sst)
 - Prognostic
-    - [Traditional Slab Ocean Model](#traditional-slab-ocean-model) (SOM)
-    - [Relaxed Slab Ocean](#relaxed-slab-ocean) (RSO)
+    - [Traditional Slab Ocean Model](##traditional-slab-ocean-model) (SOM)
+    - [Relaxed Slab Ocean](##relaxed-slab-ocean) (RSO)
 
-# SST from Observations
+## SST from Observations
 
 Using SST data derived from observations is the most common use of the data ocean model, often for AMIP style experiments to reproduce historical periods.
 
@@ -27,11 +30,11 @@ SSTICE_YEAR_END       The last year of data to use from SSTICE_DATA_FILENAME
 
 Most users will not need to edit these values from their defaults, but many scenarios require non-standard SST data, such as tropical cyclone hindcasts where the daily evolution of high-resolution SST data may be desireable.
 
-# Idealized SST
+## Idealized SST
 
 The two main uses of idealized SST modes are aquaplanet (AQP) and radiative-convective equilibrium (RCE). The latter is just a special case of an aquaplanet where the SST is [usually] a constant value everywhere, traditionally used in conjunction with special modifications to homogenize radiation and disable rotation. There are several analytically specified SST patterns established by model intercomparison projects such as the Aqua-Planet Experiment (APE)[@blackburn_APE_context_2013] and RCEMIP[@wing_rcemip1_2018,@wing_rcemip2_2024].
 
-## Idealized SST compsets
+### Idealized SST compsets
 
 The following list shows the currently defined E3SM compsets that utilize idealized SST.
 
@@ -84,17 +87,17 @@ AQP10   = Control+15N
 
 The basic RCE compsets use the `_DOCN%AQPCONST_` modifier to produce a globally constant SST value, which is set by the `DOCN_AQPCONST_VALUE` variable in `env_run.xml`. The "FRCE-MW" compsets were designed for RCEMIP-II to produce a "mock walker-cell" configuration, in which sinusoidal SST variations are applied to promote a coherent large-scale circulation.
 
-## SST Data File
+### SST Data File
 
 In addition to the analytic SST modes the user can also specify an idealized aquaplanet SST pattern via the `_DOCN%AQPFILE_` option. The `aquapfile` namelist variable is used to specify the SST pattern in this mode. Note that this option has not been used or tested recently, so the user may experience difficulty trying to use this feature.
 
-# Traditional Slab Ocean Model
+## Traditional Slab Ocean Model
 
 A slab ocean model (SOM) allows responsive SSTs to address the "infinite heat source" problem associated with prescribed SSTs, but is much cheaper than running with a full ocean model. The traditional SOM appraoch requires special inputs, such as a specified mixed layer depth pattern that can vary in time and a prescribed heat flux to account for the missing effects of ocean dynamics often referred to as "Q-flux". The Q-flux data is often estimated from a fully coupled simulation with active ocean and sea-ice so that the SOM simulation will resemble the full model.
 
 Currently, we do not have Q-flux data to drive the SOM in E3SM. An alternative appraoch is to use a "relaxed" slab ocean (RSO) in which a specified relaxation time scale is used to bring the SST field back to a target SST field. The RSO mode is much simpler to use, but carries caveats that the user should be aware of before using. See [Data Ocean - Relaxed Slab Ocean](data-ocean-RSO.md) for more information.
 
-# Relaxed Slab Ocean
+## Relaxed Slab Ocean
 
 The relaxed slab ocean (RSO) is similar in many ways to the [traditional slab ocean model](data-ocean-SOM.md), but uses a specified relaxation time scale to avoid the need for specified "Q-flux" data to represent the effects of ocean transport. The RSO implementation in E3SM was inspired by Zarzycki (2016)[@Zarzycki_TC-ocn-cpl_2016].