Skip to content

Expand CONTRIBUTING.md with development setup and guidelines#115

Closed
leofernandezg wants to merge 1 commit intocdelker:masterfrom
leofernandezg:docs/expand-contributing
Closed

Expand CONTRIBUTING.md with development setup and guidelines#115
leofernandezg wants to merge 1 commit intocdelker:masterfrom
leofernandezg:docs/expand-contributing

Conversation

@leofernandezg
Copy link
Copy Markdown

@leofernandezg leofernandezg commented Mar 26, 2026

Summary

Expands the contributing guide from a 3-line stub to a comprehensive developer onboarding document.

Changes

  • Bug reporting guidelines with checklist of what to include
  • Development environment setup (venv, editable install, test dependencies)
  • How to run the test suite (pytest --nbval-lax)
  • Code style conventions (120-char lines, PEP 8, type hints, allowed short names)
  • Pull request workflow with expectations for bug fixes, new elements, and docs
  • Step-by-step guide for adding new elements
  • Documentation build instructions (Sphinx)

Test results

Branch Passed Failed
master 470 0
this branch 470 0

Fixes #118

The contributing guide was a 3-line stub. Expanded to cover:
- Bug reporting guidelines with checklist
- Development environment setup (venv, editable install)
- How to run the test suite (pytest + nbval)
- Code style conventions (line length, PEP 8, type hints)
- Pull request workflow and expectations
- Step-by-step guide for adding new elements
- Documentation build instructions
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CONTRIBUTING.md lacks development setup, testing, and PR guidelines

2 participants