From ac675e4c65109200ff5d64fd468d02c22be54d45 Mon Sep 17 00:00:00 2001
From: Manoel Aranda Neto <5731772+marandaneto@users.noreply.github.com>
Date: Fri, 17 Apr 2026 13:24:10 +0100
Subject: [PATCH] docs: align contributing guide with ci

---
 CONTRIBUTING.md               | 17 ++++++-----------
 posthog-rails/CONTRIBUTING.md |  6 +++---
 2 files changed, 9 insertions(+), 14 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3575c80..5b72cc3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -29,19 +29,14 @@ Thanks for your interest in improving the PostHog Ruby SDK.
    ruby example.rb
    ```
 
-## Testing
+## CI-aligned checks
 
-1. Run the full test suite:
+Run the same checks CI uses before opening a PR:
 
-   ```bash
-   bin/test
-   ```
-
-2. Run a specific test if needed:
-
-   ```bash
-   bin/test spec/posthog/client_spec.rb:26
-   ```
+```bash
+bundle exec rspec
+bundle exec rubocop
+```
 
 ## Rails package
 
diff --git a/posthog-rails/CONTRIBUTING.md b/posthog-rails/CONTRIBUTING.md
index ae35127..c8ed8c5 100644
--- a/posthog-rails/CONTRIBUTING.md
+++ b/posthog-rails/CONTRIBUTING.md
@@ -4,13 +4,13 @@ This guide covers package-specific development for `posthog-rails`.
 
 For repository-level setup, see the root [CONTRIBUTING.md](../CONTRIBUTING.md).
 
-## Development
+## CI-aligned checks
 
-Run the package tests from the repository root:
+Run the same checks CI uses before opening a PR:
 
 ```bash
-bundle install
 bundle exec rspec
+bundle exec rubocop
 ```
 
 ## Pull requests