Skip to content

docs: add development environment setup guide#150

Open
mahmoudnasser1561 wants to merge 2 commits intosunpy:mainfrom
mahmoudnasser1561:docs/dev-setup
Open

docs: add development environment setup guide#150
mahmoudnasser1561 wants to merge 2 commits intosunpy:mainfrom
mahmoudnasser1561:docs/dev-setup

Conversation

@mahmoudnasser1561
Copy link

Add conda and venv/pip setup steps and link from README and docs index.

Why?

During onboarding, the steps to set up a dev environment were not easy to discover from the repository root and were spread across documentation. This PR makes it straightforward for new contributors to get started quickly.

Refs #149

Summary

Add a discoverable, repo-local development setup guide and link it from the
README and documentation index.

Motivation

As a new contributor, I found the steps for setting up a local dev environment
were not easy to find from the repository root and required digging through
documentation. This PR makes onboarding faster and reduces repeated setup
questions.

Changes

  • Add docs/development.rst with:
    • conda setup (Python 3.12)
    • venv/pip setup
    • editable install with [dev] extras
    • how to run tests and pre-commit hooks
  • Link the guide from:
    • README.rst
    • docs/index.rst

Add conda and venv/pip setup steps and link from README and docs index.
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.

1 participant