Dev: Move docstring section to a different location

Author: simmsa

CONTRIBUTING.md

@@ -237,100 +237,6 @@ end
 
 For custom validation, create functions in `mhkit/utils/` or module-specific directories.
 
-## Documentation
-
-### Docstring Format
-
-All public functions **must** have properly formatted docstrings. This is enforced by automated CI checks.
-
-#### Simple Function Template
-
-```matlab
-function Hm0 = significant_wave_height(S, frequency)
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%   Calculate significant wave height from spectral density
-%
-% Parameters
-% ------------
-%   S : vector or matrix
-%       Spectral density values [m^2/Hz]
-%   frequency : vector
-%       Frequency bins [Hz]
-%
-% Returns
-% ---------
-%   Hm0 : double
-%       Significant wave height [m]
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-arguments
-    S double
-    frequency double
-end
-
-Hm0 = 4 * sqrt(trapz(frequency, S));
-
-end
-```
-
-#### Complex Function Template (Struct Inputs/Outputs)
-
-```matlab
-function mspl = band_sound_pressure_level(spsd, octave, base, fmin, fmax)
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%   Calculate band-averaged sound pressure levels from spectral density
-%
-%   Computes sound pressure level in fractional octave bands from
-%   mean square sound pressure spectral density (SPSD).
-%
-% Parameters
-% ------------
-%   spsd : struct
-%       Mean square sound pressure spectral density
-%       spsd.data : Spectral density data [Pa^2/Hz]
-%       spsd.freq : Frequency vector [Hz]
-%       spsd.time : Time vector
-%       spsd.fs : Sampling frequency [Hz]
-%   octave : int
-%       Octave subdivision (1 = full octave, 3 = third-octave)
-%   base : int (optional)
-%       Octave base subdivision (default: 2 for true octave)
-%   fmin : double (optional)
-%       Lower frequency band limit [Hz] (default: 10)
-%   fmax : double (optional)
-%       Upper frequency band limit [Hz] (default: 100000)
-%
-% Returns
-% ---------
-%   mspl : struct
-%       Sound pressure level [dB re 1 uPa] indexed by time and frequency
-%       mspl.data : Sound pressure level data [dB re 1 uPa]
-%       mspl.freq : Center frequencies of bands [Hz]
-%       mspl.time : Time vector
-%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-arguments (Input)
-    spsd struct
-    octave {mustBeInteger, mustBePositive}
-    base {mustBeInteger} = 2
-    fmin {mustBeNumeric, mustBePositive} = 10
-    fmax {mustBeNumeric, mustBePositive} = 100000
-end
-
-arguments (Output)
-    mspl struct
-end
-
-% Implementation
-mspl = struct();
-
-end
-```
-
 ### Checking Your Docstrings
 
 Before submitting your PR, there is a python script to validate docstrings locally: