Mitchell acoustics/issue121

[MitchellAcoustics]

This pull request makes several changes across the codebase, mainly focused on documentation cleanup, test configuration improvements, and packaging adjustments. The most significant updates include removing or commenting out sections of the documentation, refining the optional dependency handling in test configuration, and updating the package manifest to better control included and excluded files.

Documentation cleanup and restructuring:

• Removed multiple detailed reference and module documentation files from the docs/reference directory, streamlining the documentation and possibly preparing for a new documentation approach. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Test configuration and dependency handling:

• Enhanced the conftest.py logic to support new dependency groups (r, satp) and improved how optional dependencies are checked and mapped to test directories. This allows for more precise control over which tests are run based on available dependencies. [1] [2] [3] [4] [5]
• Updated the test selection example in CONTRIBUTING.md to use bash syntax for clarity.

Packaging and distribution:

• Updated MANIFEST.in to more explicitly include and exclude files and directories, ensuring that only the necessary files are packaged and distributed.

Continuous integration workflow adjustments:

• Commented out steps in GitHub Actions workflows (tag-release.yml, test-tag-release.yml) that install the soundscapy[all] extra, likely due to instability or issues with those installs. Also removed a version check step to simplify the release process. [1] [2] [3]

Tutorial and notebook minor updates:

• Made small adjustments to the tutorial notebook to remove unused imports and update execution timestamps, keeping the example up to date and cleaner. [1] [2] [3] [4] [5] [6] [7]