Hoctar77 commited on
Commit
2666003
·
verified ·
1 Parent(s): 8db81fe

Added release history, reorganized checks, added paragraph and sentence length checks

Browse files
Files changed (1) hide show
  1. README.md +81 -63
README.md CHANGED
@@ -4,7 +4,7 @@ emoji: 🐨
4
  colorFrom: green
5
  colorTo: green
6
  sdk: gradio
7
- sdk_version: 5.6.0
8
  app_file: app.py
9
  pinned: false
10
  ---
@@ -25,7 +25,7 @@ The **Document Checker Tool** aims to:
25
  This tool provides **suggestions**, but the final editorial decisions rest with the document author.
26
 
27
  ### Scope
28
- The tool supports all FAA document types AIR-646 supports and includes 15 categories of checks.
29
 
30
  The tool adheres to style and guidelines derived from:
31
  - GPO Style Manual
@@ -36,28 +36,37 @@ The tool adheres to style and guidelines derived from:
36
 
37
  ---
38
 
39
- ## 2. Checker Categories Overview
40
 
41
- ### 15 Key Checker Categories
 
 
 
 
 
 
 
42
  1. **Heading Title Checks**
43
- 2. **Heading Period Format Check**
44
- 3. **Acronym Check**
45
- 4. **Acronym Usage Check**
46
- 5. **Terminology Checks**
47
  6. **Section Symbol (§) Checks**
48
- 7. **Table Caption Check**
49
- 8. **Figure Caption Check**
50
- 9. **Table/Figure Reference Check**
51
- 10. **Referenced Document Title Format Check**
52
- 11. **Double Period Check**
53
- 12. **Spacing Check**
54
- 13. **Date Format Check**
55
- 14. **Placeholder Content Check**
56
- 15. **Parenthesis Balance Check**
 
 
57
 
58
  ---
59
 
60
- ## 3. Details of Each Checker
61
 
62
  ### Heading Checks
63
 
@@ -92,20 +101,9 @@ Ensures headings have or do not have periods based on document type.
92
 
93
  ---
94
 
95
- ### Acronym and Abbreviation Checks
96
-
97
- #### 3. Acronym Check
98
- Ensures acronyms are defined at first use.
99
- - **Example:** Federal Aviation Administration (FAA)
100
-
101
- #### 4. Acronym Usage Check
102
- Identifies acronyms defined but not used.
103
-
104
- ---
105
-
106
  ### Terminology Checks
107
 
108
- #### 5. Terminology Usage Check
109
  Flags outdated or vague terms and enforces FAA terminology standards.
110
 
111
  **Examples:**
@@ -114,6 +112,17 @@ Flags outdated or vague terms and enforces FAA terminology standards.
114
 
115
  ---
116
 
 
 
 
 
 
 
 
 
 
 
 
117
  ### Section Symbol (§) Checks
118
 
119
  #### 6. Section Symbol Usage Check
@@ -125,23 +134,22 @@ Ensures proper formatting for section symbols.
125
 
126
  ---
127
 
128
- ### Table and Figure Checks
129
 
130
- #### 7 & 8. Table/Figure Caption Checks
131
- Verifies captions follow correct numbering conventions based on document type.
132
 
133
  **Examples:**
134
- - Table X-Y and Figure X-Y for Advisory Circulars and Orders.
135
- - Table X and Figure X for all other document types.
136
 
137
- #### 9. Table/Figure Reference Check
138
- Ensures references are lowercase mid-sentence and capitalized at the start of a sentence.
139
 
140
  ---
141
 
142
  ### Document Title Checks
143
 
144
- #### 10. Referenced Document Title Format Check
145
  Verifies correct formatting of referenced document titles.
146
 
147
  - **Italicize:** Advisory Circulars
@@ -150,15 +158,39 @@ Verifies correct formatting of referenced document titles.
150
 
151
  ---
152
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
153
  ### Punctuation and Spacing Checks
154
 
155
- #### 11. Double Period Check
156
  Flags unintended multiple periods.
157
 
158
  **Example:**
159
  - Corrects: "This sentence ends with two periods..".
160
 
161
- #### 12. Spacing Check
162
  Ensures proper spacing around references.
163
 
164
  **Examples:**
@@ -167,30 +199,17 @@ Ensures proper spacing around references.
167
 
168
  ---
169
 
170
- ### Date Format and Placeholder Checks
171
-
172
- #### 13. Date Format Consistency Check
173
- Ensures dates follow the "Month Day, Year" format in the document body.
174
-
175
- **Examples:**
176
- - Replace "1/15/24" with "January 15, 2024".
177
-
178
- #### 14. Placeholder Content Check
179
- Flags placeholders like "TBD" or "To be added."
180
-
181
- ---
182
-
183
- ### Parenthesis Balance Check
184
 
185
- #### 15. Parenthesis Balance Check
186
- Verifies that all parentheses are properly opened and closed.
187
 
188
- **Examples:**
189
- - Add a missing closing parenthesis to "The system (as defined in AC 25-11B performs...".
190
 
191
  ---
192
 
193
- ## 4. Practical Applications
194
 
195
  1. **Efficient Document Review:** Automated checks save time and reduce errors.
196
  2. **Consistency Across Documents:** Ensures adherence to FAA standards.
@@ -198,7 +217,7 @@ Verifies that all parentheses are properly opened and closed.
198
 
199
  ---
200
 
201
- ## 5. Conclusion and Future Updates
202
 
203
  ### Key Takeaways
204
  - Automated checkers enhance accuracy and compliance.
@@ -207,7 +226,6 @@ Verifies that all parentheses are properly opened and closed.
207
 
208
  ### What's Next?
209
  - Continue refining the tool to improve accuracy and functionality.
210
- - Explore adding new checks based on user feedback and evolving guidelines.
211
- - Investigate ignoring specific sections like the Table of Contents for better results.
212
 
213
- **Note:** This tool is a work in progress. Expect more features and updates in the future to meet evolving document requirements.
 
4
  colorFrom: green
5
  colorTo: green
6
  sdk: gradio
7
+ sdk_version: 5.8.0
8
  app_file: app.py
9
  pinned: false
10
  ---
 
25
  This tool provides **suggestions**, but the final editorial decisions rest with the document author.
26
 
27
  ### Scope
28
+ The tool supports all FAA document types AIR-646 supports and includes multiple categories of checks.
29
 
30
  The tool adheres to style and guidelines derived from:
31
  - GPO Style Manual
 
36
 
37
  ---
38
 
39
+ ## 2. Revision History
40
 
41
+ 12/8/2024: Added checks for paragraph length and sentence length. Reordered existing checks for improved workflow. Updated the date format check to exclude certain AC numbers.
42
+ 11/26/2024: Initial release with 15 checks.
43
+
44
+ ---
45
+
46
+ ## 3. Checker Categories Overview
47
+
48
+ ### 17 Key Checker Categories
49
  1. **Heading Title Checks**
50
+ 2. **Heading Period Format Check**
51
+ 3. **Terminology Checks**
52
+ 4. **Acronym Check**
53
+ 5. **Acronym Usage Check**
54
  6. **Section Symbol (§) Checks**
55
+ 7. **Date Format Check**
56
+ 8. **Placeholder Content Check**
57
+ 9. **Referenced Document Title Format Check**
58
+ 10. **Table Caption Check**
59
+ 11. **Figure Caption Check**
60
+ 12. **Table/Figure Reference Check**
61
+ 13. **Parenthesis Balance Check**
62
+ 14. **Double Period Check**
63
+ 15. **Spacing Check**
64
+ 16. **Paragraph Length Check**
65
+ 17. **Sentence Length Check**
66
 
67
  ---
68
 
69
+ ## 4. Details of Each Checker
70
 
71
  ### Heading Checks
72
 
 
101
 
102
  ---
103
 
 
 
 
 
 
 
 
 
 
 
 
104
  ### Terminology Checks
105
 
106
+ #### 3. Terminology Usage Check
107
  Flags outdated or vague terms and enforces FAA terminology standards.
108
 
109
  **Examples:**
 
112
 
113
  ---
114
 
115
+ ### Acronym and Abbreviation Checks
116
+
117
+ #### 4. Acronym Check
118
+ Ensures acronyms are defined at first use.
119
+ - **Example:** Federal Aviation Administration (FAA)
120
+
121
+ #### 5. Acronym Usage Check
122
+ Identifies acronyms defined but not used.
123
+
124
+ ---
125
+
126
  ### Section Symbol (§) Checks
127
 
128
  #### 6. Section Symbol Usage Check
 
134
 
135
  ---
136
 
137
+ ### Date Format and Placeholder Checks
138
 
139
+ #### 7. Date Format Consistency Check
140
+ Ensures dates follow the "Month Day, Year" format in the document body.
141
 
142
  **Examples:**
143
+ - Replace "1/15/24" with "January 15, 2024".
 
144
 
145
+ #### 8. Placeholder Content Check
146
+ Flags placeholders like "TBD" or "To be added."
147
 
148
  ---
149
 
150
  ### Document Title Checks
151
 
152
+ #### 9. Referenced Document Title Format Check
153
  Verifies correct formatting of referenced document titles.
154
 
155
  - **Italicize:** Advisory Circulars
 
158
 
159
  ---
160
 
161
+ ### Table and Figure Checks
162
+
163
+ #### 10 & 11. Table/Figure Caption Checks
164
+ Verifies captions follow correct numbering conventions based on document type.
165
+
166
+ **Examples:**
167
+ - Table X-Y and Figure X-Y for Advisory Circulars and Orders.
168
+ - Table X and Figure X for all other document types.
169
+
170
+ #### 12. Table/Figure Reference Check
171
+ Ensures references are lowercase mid-sentence and capitalized at the start of a sentence.
172
+
173
+ ---
174
+
175
+ ### Parenthesis Balance Check
176
+
177
+ #### 13. Parenthesis Balance Check
178
+ Verifies that all parentheses are properly opened and closed.
179
+
180
+ **Examples:**
181
+ - Add a missing closing parenthesis to "The system (as defined in AC 25-11B performs...".
182
+
183
+ ---
184
+
185
  ### Punctuation and Spacing Checks
186
 
187
+ #### 14. Double Period Check
188
  Flags unintended multiple periods.
189
 
190
  **Example:**
191
  - Corrects: "This sentence ends with two periods..".
192
 
193
+ #### 15. Spacing Check
194
  Ensures proper spacing around references.
195
 
196
  **Examples:**
 
199
 
200
  ---
201
 
202
+ ### Length Checks
 
 
 
 
 
 
 
 
 
 
 
 
 
203
 
204
+ #### 16. Paragraph Length Check
205
+ Flags paragraphs exceeding 6 sentences or 8 lines.
206
 
207
+ #### 17. Sentence Length Check
208
+ Flags sentences exceeding 35 words.
209
 
210
  ---
211
 
212
+ ## 5. Practical Applications
213
 
214
  1. **Efficient Document Review:** Automated checks save time and reduce errors.
215
  2. **Consistency Across Documents:** Ensures adherence to FAA standards.
 
217
 
218
  ---
219
 
220
+ ## 6. Conclusion and Future Updates
221
 
222
  ### Key Takeaways
223
  - Automated checkers enhance accuracy and compliance.
 
226
 
227
  ### What's Next?
228
  - Continue refining the tool to improve accuracy and functionality.
229
+ - Explore adding new checks based on user feedback and evolving guidelines.
 
230
 
231
+ **Note:** This tool is a work in progress. Expect more features and updates in the future to meet evolving document requirements.