Update patterns.json

patterns.json

@@ -32,7 +32,7 @@
             "pattern": "\\bU\\.S\\.C\\b",
             "description": "U.S.C should have a final period (U.S.C.)",
             "is_error": true,
-            "replacement": "U.S.C. (per the GPO Style Manual)"
+            "replacement": "U.S.C."
         },
         {
             "_comment": "Handle Technical Standard Order acronyms",
@@ -51,21 +51,21 @@
             "pattern": "\\bCFR Part\\b",
             "description": "CFR Part should be CFR part (lowercase)",
             "is_error": true,
-            "replacement": "CFR part (per FAA Order 1320.46)"
+            "replacement": "CFR part (per Document Drafting Handbook & FAA Order 1320.46)"
         },
         {
             "_comment": "Per the GPO Style Manual",
             "pattern": "\\bC\\.F\\.R\\.\\b",
             "description": "C.F.R. should be CFR (per the GPO Style Manual)",
             "is_error": true,
-            "replacement": "CFR (per the GPO Style Manual)"
+            "replacement": "CFR (per the GPO Style Manual & FAA Order 1320.46)"
         },
         {
             "_comment": "Replace ACO with Certification Branch",
             "pattern": "\\bACO\\b",
             "description": "ACO should be replaced with Certification Branch",
             "is_error": true,
-            "replacement": "Certification Branch"
+            "replacement": "Certification Branch (as of 2023 AIR Reorganization)"
         },
         {
             "pattern": "\\b(?:[Ww]e)\\b",
@@ -166,12 +166,12 @@
         },
         {
             "pattern": "\\babove\\b",
-            "description": "Avoid using 'above' for references",
+            "description": "Avoid using 'above' for references; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bbelow\\b",
-            "description": "Avoid using 'below' for references",
+            "description": "Avoid using 'below' for references; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
@@ -181,22 +181,22 @@
         },
         {
             "pattern": "\\bpreceding\\b",
-            "description": "Avoid using 'preceding' for references; specify the section or item explicitly",
+            "description": "Avoid using 'preceding' for references; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bfollowing\\b",
-            "description": "Avoid using 'following' for references; specify the section or item explicitly",
+            "description": "Avoid using 'following' for references; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\blatter\\b",
-            "description": "Avoid using 'latter'; specify the item explicitly",
+            "description": "Avoid using 'latter'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bformer\\b",
-            "description": "Avoid using 'former'; specify the item explicitly",
+            "description": "Avoid using 'former'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
@@ -226,32 +226,32 @@
         },
         {
             "pattern": "\\bper above\\b",
-            "description": "Avoid using 'per above'; provide a direct reference",
+            "description": "Avoid using 'per above'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bas mentioned earlier\\b",
-            "description": "Avoid using 'as mentioned earlier'; provide a direct reference",
+            "description": "Avoid using 'as mentioned earlier'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bas stated earlier\\b",
-            "description": "Avoid using 'as stated earlier'; provide a direct reference",
+            "description": "Avoid using 'as stated earlier'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bin question\\b",
-            "description": "Avoid using 'in question'; specify the item explicitly",
+            "description": "Avoid using 'in question'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\bafore\\b",
-            "description": "Avoid using archaic terms like 'afore'; specify the item explicitly",
+            "description": "Avoid using archaic terms like 'afore'; specify the section or item explicitly (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "pattern": "\\b(may|might|could|should|possibly|likely)\\b",
-            "description": "Avoid vague terms; use definitive language unless conditional meaning is intended",
+            "description": "Avoid vague terms; use definitive language unless the conditional meaning is intended",
             "is_error": true
         },
         {
@@ -270,7 +270,7 @@
             "pattern": "\\b(?:pursuant to|in accordance with|in compliance with)\\b",
             "description": "Use simpler alternatives like 'under' or 'following'",
             "is_error": true,
-            "replacement": "under (per Document Drafting Handbook)"
+            "replacement": "under (per FAA Order 1320.46)"
         },
         {
             "_comment": "Per Document Drafting Handbook",
@@ -528,7 +528,7 @@
         },
         {
             "pattern": "\\b(\\d+)\\s*to\\s*(\\d+)\\b",
-            "description": "Ensure numeric ranges use a dash (e.g., '10-20') instead of 'to'",
+            "description": "Ensure numeric ranges use a dash (e.g., '10-20') instead of 'to' (per GPO Style Manual)",
             "is_error": true
         }
     ],
@@ -743,41 +743,41 @@
         {
             "_comment": "Per GPO Style Manual",
             "pattern": "\\b(\\d+)\\s+(?:U\\.S\\.C\\.|CFR)\\s+(§|§§)\\s+(\\d+(?:\\.\\d+)*)\\b",
-            "description": "Ensure proper formatting of legal citations",
+            "description": "Format citations to U.S. Code or CFR with correct spacing and symbols, e.g., 14 CFR § 21.1 or 49 U.S.C. §§ 44701–44704",
             "is_error": true,
-            "replacement": "$1 $2 §$3 (per GPO Style Manual)"
+            "replacement": "$1 $2 $3 $4 (per GPO Style Manual & Document Drafting Handbook)"
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:refer|reference|see)\\s+(?:section|paragraph|subsection|clause)\\s+(\\d+(?:\\.\\d+)*)\\b",
-            "description": "Ensure proper formatting of cross-references",
+            "description": "Replace narrative references to numbered legal sections with standardized cross-references, e.g., 'see § 21.1'",
             "is_error": true,
-            "replacement": "see §$1"
+            "replacement": "see § $1 (per GPO Style Manual & Document Drafting Handbook)"
         }
     ],
     "regulatory_analysis": [
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:comment|commenter|commenting)\\b",
-            "description": "Ensure proper handling of public comment references",
+            "description": "Ensure proper handling of public comment references (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:cost-benefit|regulatory impact|economic impact)\\b",
-            "description": "Ensure proper handling of regulatory analysis terms",
+            "description": "Ensure proper handling of regulatory analysis terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:regulatory|economic|environmental)\\s+(?:impact|analysis|assessment)\\b",
-            "description": "Ensure proper handling of regulatory analysis terms",
+            "description": "Ensure proper handling of regulatory analysis terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:regulatory|economic|environmental)\\s+(?:impact|analysis|assessment)\\s+(?:of|for|under)\\b",
-            "description": "Ensure proper handling of regulatory analysis terms",
+            "description": "Ensure proper handling of regulatory analysis terms (per Document Drafting Handbook)",
             "is_error": true
         }
     ],
@@ -785,19 +785,19 @@
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:except|unless|provided that)\\b",
-            "description": "Ensure proper formatting of regulatory exceptions",
+            "description": "Ensure proper formatting of regulatory exceptions (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:except|unless|provided that|notwithstanding)\\b",
-            "description": "Ensure proper formatting of regulatory exceptions",
+            "description": "Ensure proper formatting of regulatory exceptions (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:except|unless|provided that|notwithstanding)\\s+(?:for|under|in)\\b",
-            "description": "Ensure proper formatting of regulatory exceptions",
+            "description": "Ensure proper formatting of regulatory exceptions (per Document Drafting Handbook)",
             "is_error": true
         }
     ],
@@ -805,37 +805,37 @@
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:compliance|enforcement)\\s+(?:date|deadline|requirement|action)\\b",
-            "description": "Ensure proper specification of compliance and enforcement terms",
+            "description": "Ensure proper specification of compliance and enforcement terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:implementation|transition|phase-in)\\s+(?:period|schedule|plan)\\b",
-            "description": "Ensure proper specification of implementation and transition terms",
+            "description": "Ensure proper specification of implementation and transition terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:compliance|implementation|enforcement)\\s+(?:date|deadline|requirement)\\b",
-            "description": "Ensure proper specification of compliance dates",
+            "description": "Ensure proper specification of compliance dates (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:compliance|enforcement)\\s+(?:with|under|of)\\b",
-            "description": "Ensure proper specification of compliance and enforcement terms",
+            "description": "Ensure proper specification of compliance and enforcement terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:implementation|transition|phase-in)\\s+(?:of|for|under)\\b",
-            "description": "Ensure proper specification of implementation and transition terms",
+            "description": "Ensure proper specification of implementation and transition terms (per Document Drafting Handbook)",
             "is_error": true
         },
         {
             "_comment": "Per Document Drafting Handbook",
             "pattern": "\\b(?:compliance|implementation|enforcement)\\s+(?:date|deadline|requirement)\\b",
-            "description": "Ensure proper specification of compliance dates",
+            "description": "Ensure proper specification of compliance dates (per Document Drafting Handbook)",
             "is_error": true
         }
     ]