Skip to content

Add contributing docs, templates, and CI#2

Merged
sukanth merged 3 commits intomasterfrom
documentation
Apr 17, 2026
Merged

Add contributing docs, templates, and CI#2
sukanth merged 3 commits intomasterfrom
documentation

Conversation

@sukanth
Copy link
Copy Markdown
Owner

@sukanth sukanth commented Apr 17, 2026

Add community and CI infrastructure: new CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, GitHub issue templates (bug_report, feature_request), a pull request template, and a CI workflow (.github/workflows/ci.yml) that runs pytest across Python 3.9/3.11/3.12. Also update README.md to reference CONTRIBUTING.md and clarify the license link. These changes onboard contributors, provide reporting templates, establish a security contact/process, and enable continuous testing for PRs and pushes to master.

Add community and CI infrastructure: new CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, GitHub issue templates (bug_report, feature_request), a pull request template, and a CI workflow (.github/workflows/ci.yml) that runs pytest across Python 3.9/3.11/3.12. Also update README.md to reference CONTRIBUTING.md and clarify the license link. These changes onboard contributors, provide reporting templates, establish a security contact/process, and enable continuous testing for PRs and pushes to master.
Copy link
Copy Markdown

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

Adds contributor-facing documentation and GitHub project scaffolding (templates + CI) to improve onboarding, standardize reporting, and ensure automated test runs on pushes/PRs to master.

Changes:

  • Add community health files: CONTRIBUTING, Code of Conduct, Security policy.
  • Add GitHub templates for issues and pull requests.
  • Add a GitHub Actions CI workflow to run pytest across Python 3.9/3.11/3.12 and update README to reference contributing + license.

Reviewed changes

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

Show a summary per file
File Description
SECURITY.md Introduces a security policy with reporting instructions and scope notes.
README.md Adds a Contributing section and clarifies the license link.
CONTRIBUTING.md Provides development setup, contribution workflow, and (currently) project structure guidance.
CODE_OF_CONDUCT.md Adds Contributor Covenant-based community standards and enforcement section.
.github/workflows/ci.yml Adds CI workflow to run pytest on supported Python versions for pushes/PRs to master.
.github/pull_request_template.md Adds a PR template with testing + documentation checklist.
.github/ISSUE_TEMPLATE/feature_request.md Adds a structured feature request issue template.
.github/ISSUE_TEMPLATE/bug_report.md Adds a structured bug report issue template.

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

Comment thread CONTRIBUTING.md Outdated
Comment on lines +61 to +64
├── cli.py # CLI entry point (argparse)
├── indexer.py # Bookmark parser + embedding
├── searcher.py # Vector search logic
└── store.py # SQLite storage layer
Comment thread CONTRIBUTING.md Outdated

## Questions?

Open a [discussion](https://github.com/sukanth/mindmark/issues) or reach out via an issue. We're happy to help!
Comment thread CONTRIBUTING.md Outdated
cd mindmark
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .[dev]
@sukanth
Copy link
Copy Markdown
Owner Author

sukanth commented Apr 17, 2026

@copilot apply changes based on the comments in this thread

Copilot AI and others added 2 commits April 17, 2026 05:31
- Quote pip extras and use python -m pip for cross-shell compatibility
- Update project structure tree to reflect actual src/mindmark/ layout
- Fix misleading 'discussion' link text to match the Issues URL"

Agent-Logs-Url: https://github.com/sukanth/mindmark/sessions/444409c7-633a-4e37-92f9-23cb9fc4f44d

Co-authored-by: sukanth <8810504+sukanth@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 17, 2026

@copilot apply changes based on the comments in this thread

Applied all three review fixes in commit 58942f7 (plus a minor follow-up in f2ba11d):

  1. pip install (line 12) – changed to python -m pip install -e ".[dev]" for cross-shell compatibility.
  2. Project structure (lines 61-64) – updated the tree to reflect the actual src/mindmark/ layout: __init__.py, __main__.py, cli.py, index.py, and parser.py.
  3. "discussion" link (line 69) – changed link text from "discussion" to "issue" to match the GitHub Issues URL it points to, and trimmed the now-redundant trailing phrase.

@sukanth sukanth merged commit 5d95263 into master Apr 17, 2026
3 checks passed
@sukanth sukanth deleted the documentation branch April 17, 2026 05:33
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.

3 participants