Clarify path filters.

jmacdotorg · jmacdotorg · commit f6ec2dc44e8b · 2025-06-19T14:47:38.000-04:00
diff --git a/docs/guides/initial-configuration.md b/docs/guides/initial-configuration.md
@@ -120,15 +120,15 @@ By default, CodeRabbit applies the same review instructions and contexts to all
 
 Each path instruction specifies a path specification and a set of instructions, the latter of which you express using natural language. For example, you can add a section like this to your repository's `coderabbit.yaml` file:
 
-```
+```yaml
 path_instructions:
     - path: `src/**/*.{ts,tsx,js}`
-      instructions:
-		- Review the React.js, TypeScript, JavaScript code for best practices
-           - Check for common security vulnerabilities such as:
-       	    - SQL Injection
-        	  - Insecure dependencies
-       	    - Sensitive data exposure
+    instructions:
+    - Review the React.js, TypeScript, JavaScript code for best practices
+        - Check for common security vulnerabilities such as:
+        - SQL Injection
+        - Insecure dependencies
+        - Sensitive data exposure
 ```
 
 For more information, see [Path instructions](/reference/configuration#path-instructions) in the configuration reference.
diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md
@@ -36,8 +36,8 @@ Each entry in this reference corresponds to a single CodeRabbit configuration se
     </table>
   </TabItem>
   <TabItem value="yaml" label="coderabbit.yaml">
-		_This setting can be defined only in the web UI settings for your
-		organization._
+    _This setting can be defined only in the web UI settings for your
+    organization._
   </TabItem>
 </Tabs>
 
@@ -800,22 +800,19 @@ Path filters, if defined, restrict the portions of your repository that CodeRabb
 uses for context when preparing code reviews.
 
 You can define a list of path specifications, relative to the root of your
-repository, to use as path filters. These path specifications can use extended
-glob patterns.
+repository, to use as path filters.
 
-If you define at least one path filter, then CodeRabbit restricts its reviews
-only to files whose paths meet all of the following criteria:
-
-- The file must match at least one filter that doesn't begin with a leading `!` character.
-- The file must match none of the filters that begin with a leading `!` character.
+Paths can be _exclude paths_, which start with a leading `!` character, or _include
+paths_. If the list of paths contains at least one include path, then CodeRabbit
+includes _only_ files that match the provided paths.
 
 For example, the following list of path filters instructs CodeRabbit to limit its reviews
-only to files found in the `src` top-level directory, but exclude any `.txt` or `.js`
+only to files found in the `src` top-level directory, but exclude any `.bin` or `.csv`
 files:
 
-```
+```bash
 src/**
-!**/*.{txt,js}
+!**/*.{bin,csv}
 ```
 
 :::note
