Contributing

We welcome any help—bug fixes, feature proposals, usage questions (xiaziyna at gmail dot com).

Report Bugs & Problems

Check for duplicates: existing issues.
If none match, open a new issue and include: - PyStarshade version: pip show pystarshade - Python version & OS - Repro steps & minimal code snippet - Error messages or tracebacks

Note

Tag it with bug if appropriate.

Open a new issue, choose the question label, and describe what you want + why.

Fork the repo and branch from main:

git clone git@github.com:xiaziyna/PyStarshade.git
cd PyStarshade
git checkout -b feature/short-name

Follow style: - Add or update tests in tests/ - Verify all tests pass with pytest
Commit with clear messages, e.g.:
```
feat: add widget-alignment option
```
Push your branch and open a Pull Request against main: - Explain your changes and why

Keep requests limited in scope and explain why your change enhances the utility of the tool.