Spaces:
Sleeping
Sleeping
Added release history, reorganized checks, added paragraph and sentence length checks
Browse files
README.md
CHANGED
@@ -4,7 +4,7 @@ emoji: 🐨
|
|
4 |
colorFrom: green
|
5 |
colorTo: green
|
6 |
sdk: gradio
|
7 |
-
sdk_version: 5.
|
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
|
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.
|
40 |
|
41 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
42 |
1. **Heading Title Checks**
|
43 |
-
2. **Heading Period Format Check**
|
44 |
-
3. **
|
45 |
-
4. **Acronym
|
46 |
-
5. **
|
47 |
6. **Section Symbol (§) Checks**
|
48 |
-
7. **
|
49 |
-
8. **
|
50 |
-
9. **
|
51 |
-
10. **
|
52 |
-
11. **
|
53 |
-
12. **
|
54 |
-
13. **
|
55 |
-
14. **
|
56 |
-
15. **
|
|
|
|
|
57 |
|
58 |
---
|
59 |
|
60 |
-
##
|
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 |
-
####
|
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 |
-
###
|
129 |
|
130 |
-
#### 7
|
131 |
-
|
132 |
|
133 |
**Examples:**
|
134 |
-
-
|
135 |
-
- Table X and Figure X for all other document types.
|
136 |
|
137 |
-
####
|
138 |
-
|
139 |
|
140 |
---
|
141 |
|
142 |
### Document Title Checks
|
143 |
|
144 |
-
####
|
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 |
-
####
|
156 |
Flags unintended multiple periods.
|
157 |
|
158 |
**Example:**
|
159 |
- Corrects: "This sentence ends with two periods..".
|
160 |
|
161 |
-
####
|
162 |
Ensures proper spacing around references.
|
163 |
|
164 |
**Examples:**
|
@@ -167,30 +199,17 @@ Ensures proper spacing around references.
|
|
167 |
|
168 |
---
|
169 |
|
170 |
-
###
|
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 |
-
####
|
186 |
-
|
187 |
|
188 |
-
|
189 |
-
|
190 |
|
191 |
---
|
192 |
|
193 |
-
##
|
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 |
-
##
|
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.
|