Cleaned up docstrings on methods

[VisLab]

No description provided.

[Copilot]

Pull request overview

This PR improves the public-facing documentation of the HED Python codebase by adding/standardizing docstrings across validators, tools, and scripts, and by expanding the Sphinx API reference pages accordingly. It also hardens GitHub Actions workflows by explicitly setting minimal contents: read permissions.

Changes:

• Add/standardize Google-style docstrings for multiple validator/tool utility methods and CLI entry points.
• Expand Sphinx API docs to include additional validator/tool classes and utility modules.
• Add explicit permissions: contents: read to selected GitHub Actions workflows.

Reviewed changes

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

Show a summary per file

File	Description
hed/validator/util/tag_util.py	Adds docstring for deprecated-tag checking helper.
hed/validator/util/string_util.py	Documents run_string_validator behavior/return type.
hed/validator/util/dup_util.py	Adds module/class docstrings for duplicate-checking utility.
hed/validator/util/class_util.py	Adds docstrings to value-class reporting helpers and value-class validators.
hed/validator/util/char_util.py	Documents character-level validation helpers and return shapes.
hed/validator/spreadsheet_validator.py	Adds class docstring describing spreadsheet validation role.
hed/validator/sidecar_validator.py	Adds class docstring describing sidecar validation role.
hed/validator/reserved_checker.py	Adds module/class/method docstrings for reserved tag checking singleton.
hed/tools/util/io_util.py	Documents get_basename behavior and example.
hed/tools/bids/bids_util.py	Adds module/function docstrings for schema loading and sidecar inheritance utilities.
hed/tools/bids/bids_file_group.py	Documents create_file_group factory method.
hed/tools/analysis/hed_type.py	Documents key properties and summary methods.
hed/tools/analysis/hed_tag_counts.py	Documents get_empty helper.
hed/tools/analysis/events_summary.py	Adds module/class/method docstrings for event summarization helpers.
hed/tools/analysis/event_checker.py	Adds module/class docstrings for event-level quality checker(s).
hed/scripts/validate_schemas.py	Adds module docstring and documents main entry point contract.
hed/scripts/validate_bids.py	Documents CLI entry point and dataset-validation helper.
hed/scripts/schema_script_util.py	Adds module docstring describing shared CLI utilities.
hed/scripts/hed_convert_schema.py	Adds module docstring and documents main entry point contract.
hed/scripts/add_hed_ids.py	Adds module docstring and documents main entry point contract.
hed/scripts/__init__.py	Adds package docstring clarifying legacy/deprecated scripts.
docs/api/validator.rst	Expands validator API page with additional classes/utilities.
docs/api/tools.rst	Expands tools API page with additional analysis/BIDS/util modules and classes.
.github/workflows/test_installer.yaml	Adds explicit minimal GitHub Actions permissions.
.github/workflows/spec_tests.yaml	Adds explicit minimal GitHub Actions permissions.
.github/workflows/ci_windows.yaml	Adds explicit minimal GitHub Actions permissions.