Contributor Guide

• How to Contribute
  • Impostor syndrome disclaimer
  • Contributing code or documentation to PlasmaPy
  • Towncrier changelog entries
    • Footnotes
• Contributor Covenant Code of Conduct
  • Our Pledge
  • Our Standards
  • Enforcement Responsibilities
  • Scope
  • Enforcement
  • Enforcement Guidelines
    • 1. Correction
    • 2. Warning
    • 3. Temporary Ban
    • 4. Permanent Ban
  • Attribution
• Installing PlasmaPy for Development
  • Obtaining PlasmaPy source code
  • Setting up an environment for development
    • Conda
    • Virtualenv
  • Installing your own dev version
• Code Development Guidelines
  • Coding Style
    • TL;DR: use pre-commit
    • PlasmaPy Code Style Guide, codified
  • Branches, commits, and pull requests
    • Commit Messages
  • Documentation
  • Warnings and Exceptions
  • Units
  • Equations and Physical Formulae
  • Angular Frequencies
  • Examples
  • Benchmarks
• Changelog Guide
  • Adding a changelog entry
  • Changelog guidelines
  • Building the changelog
• Testing Guide
  • Introduction
  • Running tests
    • Using GitHub
    • Using pytest
    • Using tox
    • Using an integrated development environment
  • Writing Tests
    • Locating tests
    • Assertions
    • Floating point comparisons
    • Testing warnings and exceptions
    • Test independence and parametrization
    • Fixtures
    • Property-based testing
  • Code coverage
    • Generating coverage reports with pytest
    • Excluding lines in coverage reports
    • Coverage configurations
  • Best practices
• Documentation Guide
  • Building documentation
    • Prerequisites
    • Building documentation with make
    • Building documentation with tox
  • Documentation tools
    • ReStructuredText
    • Markdown
    • Sphinx
  • Writing documentation
    • Docstrings
    • Definitions
  • Documentation guidelines
    • Docstring guidelines
    • Narrative documentation guidelines
• Release Guide
  • Pre-release
  • Release
  • Post-release
    • Compatibility with Prior Versions of Python, NumPy, and Astropy