Skip to content

docs: move local setup and build instructions into SETUP.md - #498

Open
ishikajain-234 wants to merge 1 commit into
numfocus:mainfrom
ishikajain-234:split-setup-instructions-466
Open

ishikajain-234 wants to merge 1 commit into
numfocus:mainfrom
ishikajain-234:split-setup-instructions-466

Conversation

@ishikajain-234

Copy link
Copy Markdown

Description of Changes

This PR resolves #466 by extracting the local setup, installation, and build documentation from README.md into a dedicated SETUP.md file:

  • Created SETUP.md: Contains comprehensive instructions for environment setup (both Conda and pip/venv), dependency installation, local Sphinx building, and local preview/server options.
  • Streamlined README.md: Replaced the verbose build instructions under ## How to Build and Run the Site Locally with a direct link and reference to SETUP.md.
  • Preserved Existing Sections: No changes made to the project overview, contribution workflow, or contributor lists.

Related Issue

Fixes #466

Type of Change

  • 🐛 Bug Fix — Fixes a documented issue or incorrect behavior
  • ✨ Content Enhancement — Updates or improves existing content
  • ✍️ New Content — Adds new chapters, examples, or significant sections
  • 🛠️ Other — Please describe in the Description of Changes section

Additional Notes (Optional)

Documentation restructuring; verified markdown syntax rendering.

Checklist

  • I have searched open pull requests to avoid duplicates.
  • I have built the book locally using the build instructions and verified my changes work as expected. (N/A: Documentation-only restructuring of root README and SETUP.md; no content in DISCOVER/ was modified)
  • I have written clear, conventional commit messages, as per the Pull Request Guidelines.

Extract environment setup (conda/pip) and local build/preview
instructions from README.md into a dedicated SETUP.md file to
keep the README concise and focused on the project overview.

Fixes numfocus#466
@netlify

netlify Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

❌ Deploy Preview for stupendous-kringle-a86e81 failed.

Name Link
🔨 Latest commit 6c08642
🔍 Latest deploy log https://app.netlify.com/projects/stupendous-kringle-a86e81/deploys/6ab49f8caed876000830fd60

This branch has not been deployed

No deployments
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.

Split setup instructions from README

1 participant