Skip to content

docs: add user-facing README and contributor guide#24

Merged
sozercan merged 2 commits into
masterfrom
agent/user-facing-readme
Jul 16, 2026
Merged

docs: add user-facing README and contributor guide#24
sozercan merged 2 commits into
masterfrom
agent/user-facing-readme

Conversation

@sozercan

@sozercan sozercan commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

  • refocus the README on installation, Finder toolbar setup, usage, and permissions
  • add a custom app icon and Finder-to-VS Code hero graphic
  • improve navigation and scanability with badges, feature cards, behavior tables, and a permission callout
  • move development requirements, testing, packaging, and release guidance into CONTRIBUTING.md

Validation

  • git diff --check
  • verified both README graphics are valid PNG files
  • Tests not run (documentation-only changes)

Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Copilot AI review requested due to automatic review settings July 16, 2026 06:22

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Refocuses user documentation and separates contributor workflows.

Changes:

  • Adds streamlined installation, Finder setup, usage, and permissions guidance.
  • Moves development, testing, packaging, and release instructions into CONTRIBUTING.md.
Show a summary per file
File Description
README.md Provides user-facing setup and usage guidance.
CONTRIBUTING.md Documents development and release workflows.

Review details

Tip

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

  • Files reviewed: 2/2 changed files
  • Comments generated: 2
  • Review effort level: Medium

Comment thread CONTRIBUTING.md

## Development requirements

- macOS 12 or newer
Comment thread CONTRIBUTING.md

Pushing a `v*` tag runs `.github/workflows/release.yml`. The workflow builds a universal app, signs it, creates a GitHub release, and updates `Casks/open-in-code.rb` in [`sozercan/homebrew-repo`](https://github.com/sozercan/homebrew-repo).

Public releases require all of these GitHub Actions secrets:
Signed-off-by: Sertac Ozercan <sozercan@gmail.com>
Copilot AI review requested due to automatic review settings July 16, 2026 06:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review details

  • Files reviewed: 2/4 changed files
  • Comments generated: 2
  • Review effort level: Medium

Comment thread CONTRIBUTING.md

## Development requirements

- macOS 12 or newer
Comment thread CONTRIBUTING.md

Pushing a `v*` tag runs `.github/workflows/release.yml`. The workflow builds a universal app, signs it, creates a GitHub release, and updates `Casks/open-in-code.rb` in [`sozercan/homebrew-repo`](https://github.com/sozercan/homebrew-repo).

Public releases require all of these GitHub Actions secrets:
@sozercan
sozercan merged commit 454cbed into master Jul 16, 2026
2 checks passed
@sozercan
sozercan deleted the agent/user-facing-readme branch July 16, 2026 06:32
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