Merge pull request #557 from NoeFabris/docs/wording-improvements

Docs/wording improvements

Author: giuliovv

README.md

@@ -24,7 +24,7 @@ Enable Opencode to authenticate against **Antigravity** (Google's IDE) via OAuth
 <summary><b>⚠️ Terms of Service Warning — Read Before Installing</b></summary>
 
 > [!CAUTION]
-> Using this plugin (and any proxy for antgravity) violate Google's Terms of Service. A number of users have reported their Google accounts being **banned** or **shadow-banned** (restricted access without explicit notification).
+> Using this plugin (and any proxy for Antigravity) violates Google's Terms of Service. A number of users have reported their Google accounts being **banned** or **shadow-banned** (restricted access without explicit notification).
 >
 > **By using this plugin, you acknowledge:**
 > - This is an unofficial tool not endorsed by Google
@@ -257,7 +257,7 @@ For details on load balancing, dual quota pools, and account storage, see [docs/
 
 ---
 
-## Troubleshoot
+## Troubleshooting
 
 > **Quick Reset**: Most issues can be resolved by deleting `~/.config/opencode/antigravity-accounts.json` and running `opencode auth login` again.
 
@@ -677,7 +677,7 @@ See the full [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for solutions to c
 
 ## Support
 
-If this plugin helps you, consider supporting its maintenance:
+If this plugin saves you time, consider supporting its development:
 
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/S6S81QBOIR)
 

docs/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Architecture Guide
 
-**Last Updated:** December 2025
+**Last Updated:** April 2026
 
 This document explains how the Antigravity plugin works, including the request/response flow, Claude-specific handling, and session recovery.
 

docs/CONFIGURATION.md

@@ -8,7 +8,7 @@ Create `~/.config/opencode/antigravity.json` (or `.opencode/antigravity.json` in
 }
 ```
 
-Most settings have sensible defaults. Only configure what you need.
+Most settings have sensible defaults — only configure what you need.
 
 ---
 

docs/MODEL-VARIANTS.md

@@ -1,6 +1,6 @@
 # Model Variants
 
-OpenCode's variant system allows you to configure thinking budget dynamically instead of defining separate models for each thinking level.
+OpenCode's variant system lets you configure the thinking budget dynamically without defining separate models for each thinking level.
 
 ---
 

docs/MULTI-ACCOUNT.md

@@ -1,6 +1,6 @@
 # Multi-Account Setup
 
-Add multiple Google accounts to increase your combined quota. The plugin automatically rotates between accounts when one is rate-limited.
+Add multiple Google accounts to increase your combined quota and improve availability. The plugin automatically rotates between accounts when one is rate-limited.
 
 ```bash
 opencode auth login  # Run again to add more accounts

docs/TROUBLESHOOTING.md

@@ -1,6 +1,6 @@
 # Troubleshooting
 
-Common issues and solutions for the Antigravity Auth plugin.
+Solutions to common issues with the Antigravity Auth plugin.
 
 > **Quick Reset**: Most issues can be resolved by deleting `~/.config/opencode/antigravity-accounts.json` and running `opencode auth login` again.
 
@@ -24,7 +24,7 @@ OpenCode uses `~/.config/opencode/` on **all platforms** including Windows.
 ## Quick Fixes
 
 ### Auth problems
-Delete the token file and re-login:
+Delete the accounts file and re-authenticate:
 ```bash
 rm ~/.config/opencode/antigravity-accounts.json
 opencode auth login

scripts/README-PI.md

@@ -15,7 +15,7 @@ Use your Raspberry Pi as a persistent, self-hosted runner for Opencode Triage. T
 5. Copy the **Token** shown in the "Configure" section (you'll need it in Step 2).
 
 ## Step 2: Run the Setup Script
-Copy the `scripts/` folder to your Pi (or just copy-paste the content).
+Copy the `scripts/` folder to your Pi, or copy-paste the script content directly.
 
 ```bash
 # On your Pi