[CLEANUP] Numpy-docstrings and type annotations

[eleanorfrajka]

Description:

Updating docstrings to be numpy-style.

Added type annotations to function signatures.

[Copilot]

Pull Request Overview

This PR converts function docstrings from Google style to NumPy style and adds comprehensive type annotations to function signatures throughout the seagliderOG1 package.

• Standardized all docstrings to follow NumPy documentation format with proper section headers
• Added type annotations to all function signatures with appropriate imports (e.g., xr.Dataset, union types)
• Enhanced documentation with more detailed parameter descriptions and better structure

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
seagliderOG1/writers.py	Added xarray import and type annotations to save_dataset function
seagliderOG1/vocabularies.py	Added comprehensive module-level docstring and improved inline comments
seagliderOG1/readers.py	Added module docstring and converted all functions to NumPy-style docs with type annotations
seagliderOG1/plotters.py	Added module docstring and converted plotting functions to NumPy-style docs with type annotations
seagliderOG1/convertOG1.py	Added module docstring and converted conversion functions to NumPy-style docs with type annotations

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}