Polish README and add Rust Book screenshots
This commit is contained in:
@@ -15,6 +15,7 @@
|
|||||||
- Consolidated engineering guidance into contributing docs and App Store packaging into release docs.
|
- Consolidated engineering guidance into contributing docs and App Store packaging into release docs.
|
||||||
- Documented that vibe coded pull requests are welcome when they include clear change documentation, strict QA, and UI screenshots or recordings when relevant.
|
- Documented that vibe coded pull requests are welcome when they include clear change documentation, strict QA, and UI screenshots or recordings when relevant.
|
||||||
- Documented `https://www.akkolli.net/ihatepdfs` as the project website and `akshaykolli@hotmail.com` as the support contact.
|
- Documented `https://www.akkolli.net/ihatepdfs` as the project website and `akshaykolli@hotmail.com` as the support contact.
|
||||||
|
- Clarified that the project is vibe coded and maintained with AI agents, and that feature requests and agent-assisted PRs are welcome under the QA guidelines.
|
||||||
|
|
||||||
## Version 0.4.0 (build 6) - 2026-06-25
|
## Version 0.4.0 (build 6) - 2026-06-25
|
||||||
|
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ I Hate PDFs is a native macOS app for local PDF reading and annotation. Contribu
|
|||||||
|
|
||||||
By contributing, you agree that your contribution is licensed under GNU General Public License version 2 only.
|
By contributing, you agree that your contribution is licensed under GNU General Public License version 2 only.
|
||||||
|
|
||||||
Vibe coded pull requests are welcome. This is a vibe coded repo, but vibe coded does not mean unreviewed: every change must be understandable, documented, tested at the right level, and held to the same strict QA bar as hand-written code.
|
This project is vibe coded and maintained with AI agents. Feature requests are welcome; the maintainer will get to them as time allows. Agent-assisted pull requests are welcome too, but vibe coded does not mean unreviewed: every change must be understandable, documented, tested at the right level, and held to the same strict QA bar as hand-written code.
|
||||||
|
|
||||||
## Before You Start
|
## Before You Start
|
||||||
|
|
||||||
|
|||||||
27
README.md
27
README.md
@@ -52,24 +52,14 @@ The direct-download DMG is separate from the Mac App Store build. The App Store
|
|||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- Open local `.pdf` files from disk.
|
- Incredibly small app size: v0.4 ships as a 957 KB direct-download DMG, with a 253 KB Apple Silicon archive and a 287 KB Intel archive.
|
||||||
- Drag a PDF onto the empty app window to open it.
|
- Extremely fast native PDF reading: built on SwiftUI, AppKit, and PDFKit instead of a bundled browser, runtime, database, or PDF engine.
|
||||||
- Read with smooth PDFKit scrolling, Retina rendering, zoom, fit-to-width, fit-to-page, and page navigation.
|
- Power- and size-efficient by design: minimal assets, no bundled services, and no background sync workload.
|
||||||
- Search selectable text PDFs from a compact toolbar control.
|
- Local-first privacy: opens user-selected PDFs from disk and does not require accounts, analytics, tracking, or cloud upload.
|
||||||
- Start each opened PDF in a focused single-pane reading layout, with the document fit to the available width and sidebars hidden until requested.
|
- No internet auto-updater: releases are explicit downloads, so the app is not running update checks in the background.
|
||||||
- Adapt the reader layout across compact, regular, and wide Mac windows while preserving usable PDF width.
|
- No AI features: no summaries, remote prompts, embeddings, model downloads, or document analysis.
|
||||||
- Configure highlight and comment colors, including opacity, from Settings.
|
- Clean review system: focused highlighting, commenting, replies, bookmarks, search, and sidebars that stay hidden until needed.
|
||||||
- Reopen recent PDFs from the empty window or File > Open Recent.
|
- Standards-compatible annotations: comments and highlights are written back into PDFs so they remain useful in common PDF readers.
|
||||||
- Close the current PDF back to the empty window without closing the app window.
|
|
||||||
- Create standalone highlights from selected text.
|
|
||||||
- Create selected-text comments and underline comments.
|
|
||||||
- Create free-text annotations directly on the page.
|
|
||||||
- Press Return to save comments and replies, or Shift-Return for a new line.
|
|
||||||
- Click commented or underlined text in the PDF to reopen and edit the comment in place.
|
|
||||||
- Save annotations directly into the original PDF after an overwrite warning.
|
|
||||||
- Save As a new annotated copy.
|
|
||||||
- Share the annotated PDF through the native macOS share picker.
|
|
||||||
- Review annotations in a comments sidebar with page grouping, search, filters, replies, edit/delete, and click-to-navigate.
|
|
||||||
|
|
||||||
## Privacy And Support
|
## Privacy And Support
|
||||||
|
|
||||||
@@ -159,6 +149,7 @@ Open source contribution policy:
|
|||||||
|
|
||||||
- Contributions are accepted under GPL-2.0-only. See [LICENSE](LICENSE).
|
- Contributions are accepted under GPL-2.0-only. See [LICENSE](LICENSE).
|
||||||
- Vibe coded pull requests are welcome, but they must include clear change documentation, strict QA notes, and screenshots or recordings for UI changes.
|
- Vibe coded pull requests are welcome, but they must include clear change documentation, strict QA notes, and screenshots or recordings for UI changes.
|
||||||
|
- This project is vibe coded and maintained with AI agents. Feature requests are welcome, and agent-assisted PRs are welcome when they follow the QA and contribution guidelines.
|
||||||
- Start with [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
|
- Start with [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
|
||||||
- UI pull requests must include before/after screenshots or a short screen recording.
|
- UI pull requests must include before/after screenshots or a short screen recording.
|
||||||
- Screenshots, recordings, and committed media files included with a pull request must each be under 1 MB.
|
- Screenshots, recordings, and committed media files included with a pull request must each be under 1 MB.
|
||||||
|
|||||||
Binary file not shown.
|
Before Width: | Height: | Size: 451 KiB After Width: | Height: | Size: 875 KiB |
BIN
docs/screenshots/rust-book-01.png
Normal file
BIN
docs/screenshots/rust-book-01.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 274 KiB |
BIN
docs/screenshots/rust-book-02.png
Normal file
BIN
docs/screenshots/rust-book-02.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 900 KiB |
BIN
docs/screenshots/rust-book-03.png
Normal file
BIN
docs/screenshots/rust-book-03.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 950 KiB |
BIN
docs/screenshots/rust-book-04.png
Normal file
BIN
docs/screenshots/rust-book-04.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 901 KiB |
Reference in New Issue
Block a user