Skip to content

docs: separate maintainer guidance from user docs#36

Merged
qartik merged 3 commits into
mainfrom
ks/qir2-maintenance
Mar 19, 2026
Merged

docs: separate maintainer guidance from user docs#36
qartik merged 3 commits into
mainfrom
ks/qir2-maintenance

Conversation

@qartik
Copy link
Copy Markdown
Member

@qartik qartik commented Mar 6, 2026

Summary

Move maintainer-oriented setup and workflow guidance out of the README and into DEVELOPMENT.md, and align the local lint/pre-commit workflow with the current maintainer docs.

Included

  • README focused on installation and usage
  • CONTRIBUTING points to maintainer workflow docs
  • DEVELOPMENT.md for setup, testing, linting, and LLVM maintenance notes, including simplified macOS/Linux LLVM environment guidance
  • Replace the Rust pre-commit hook integration with the cargo hook set
  • Align make lint with the pre-commit Rust hooks to avoid redundant checks

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Moves maintainer/developer workflow documentation out of the user-facing README into a dedicated DEVELOPMENT.md, keeping contribution guidance linked and easier to find.

Changes:

  • Removed development/setup/testing content from README.md to keep it focused on install + usage.
  • Added DEVELOPMENT.md with setup/build/test/lint/stubs instructions and LLVM upgrade checklist.
  • Updated CONTRIBUTING.md to point contributors to DEVELOPMENT.md (and removed redundant testing details).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File Description
README.md Removes maintainer guidance; adds pointer to DEVELOPMENT.md from Contributing section.
DEVELOPMENT.md New maintainer/developer workflow doc (setup/build/test/LLVM upgrades).
CONTRIBUTING.md Updates contributor onboarding link from README “Development” section to DEVELOPMENT.md.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread DEVELOPMENT.md
Comment thread DEVELOPMENT.md Outdated
Comment thread README.md Outdated
Comment thread CONTRIBUTING.md Outdated
@qartik qartik force-pushed the ks/qir2-maintenance branch 2 times, most recently from b989e62 to 2417120 Compare March 6, 2026 19:40
@qartik qartik force-pushed the ks/qir2-maintenance branch from 2417120 to 08a3f88 Compare March 6, 2026 19:53
@qartik qartik force-pushed the ks/qir2-maintenance branch from 08a3f88 to 568f804 Compare March 6, 2026 20:03
@qartik qartik changed the base branch from ks/qir2-ci to ks/qir2-core March 6, 2026 20:03
@qartik qartik changed the base branch from ks/qir2-core to main March 6, 2026 20:10
@qartik qartik marked this pull request as draft March 6, 2026 20:10
@qartik qartik force-pushed the ks/qir2-maintenance branch 3 times, most recently from a24b2e1 to c5019dd Compare March 6, 2026 20:35
@qartik qartik force-pushed the ks/qir2-maintenance branch from 936021b to 598c667 Compare March 19, 2026 15:22
@qartik qartik marked this pull request as ready for review March 19, 2026 15:22
@qartik qartik force-pushed the ks/qir2-maintenance branch from 598c667 to 7b8c982 Compare March 19, 2026 15:25
@qartik qartik requested a review from Copilot March 19, 2026 15:33
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@qartik qartik merged commit 6952144 into main Mar 19, 2026
11 checks passed
@qartik qartik deleted the ks/qir2-maintenance branch March 19, 2026 15:37
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.

2 participants