swadhin / opengrammar public

swadhinbiswas

[email protected]
2026-03-14 19:14:44 +0600 committed NaN years ago
3c5564b
commit 3c5564b
1 file changed
+532 -0
Showing 1 changed file+532-0
docs/11-writing-statistics.md
▼docs/11-writing-statistics.md
+532-0
@@ -0,0 +1,532 @@
1
+# 📊 Writing Statistics Guide
2
+
3
+Analyze and improve your writing with detailed statistics and metrics.
4
+
5
+---
6
+
7
+## 📋 Overview
8
+
9
+OpenGrammar provides comprehensive writing analytics to help you understand and improve your writing style.
10
+
11
+---
12
+
13
+## 📈 Available Metrics
14
+
15
+### Basic Counts
16
+
17
+#### Words
18
+**What it measures:** Total number of words in your text
19
+
20
+**Why it matters:**
21
+- Track writing progress
22
+- Meet word count requirements
23
+- Monitor document length
24
+
25
+**Example:**
26
+```
27
+Text: "The quick brown fox jumps over the lazy dog"
28
+Word Count: 9
29
+```
30
+
31
+#### Characters
32
+**What it measures:** Total characters (with and without spaces)
33
+
34
+**Why it matters:**
35
+- Social media limits (Twitter: 280 chars)
36
+- SMS message length
37
+- Meta descriptions
38
+
39
+**Example:**
40
+```
41
+Text: "Hello World"
42
+Characters (with spaces): 11
43
+Characters (no spaces): 10
44
+```
45
+
46
+#### Sentences
47
+**What it measures:** Number of complete sentences
48
+
49
+**Why it matters:**
50
+- Sentence variety
51
+- Writing rhythm
52
+- Readability
53
+
54
+**Example:**
55
+```
56
+Text: "Hello. How are you? I hope you're well!"
57
+Sentences: 3
58
+```
59
+
60
+#### Paragraphs
61
+**What it measures:** Number of paragraph breaks
62
+
63
+**Why it matters:**
64
+- Document structure
65
+- Visual breaks
66
+- Organization
67
+
68
+---
69
+
70
+### Readability Scores
71
+
72
+#### Flesch Reading Ease Score
73
+
74
+**Scale:** 0-100 (higher = easier to read)
75
+
76
+**Interpretation:**
77
+```
78
+90-100: Very Easy (5th grade) ████████████████████
79
+80-89: Easy (6th grade) ██████████████████
80
+70-79: Fairly Easy (7th grade) ████████████████
81
+60-69: Standard (8th-9th grade) ██████████████
82
+50-59: Fairly Difficult (10th-12th) ████████████
83
+30-49: Difficult (College) ██████████
84
+0-29: Very Difficult (Graduate) ██████
85
+```
86
+
87
+**Formula:**
88
+```
89
+206.835 - 1.015 × (words/sentences) - 84.6 × (syllables/words)
90
+```
91
+
92
+**Tips to Improve:**
93
+- Use shorter sentences
94
+- Choose simpler words
95
+- Break up complex ideas
96
+
97
+#### Flesch-Kincaid Grade Level
98
+
99
+**Scale:** US grade levels (1-18+)
100
+
101
+**Interpretation:**
102
+```
103
+1-6: Elementary School
104
+7-9: Middle School
105
+10-12: High School
106
+13-16: College
107
+17+: Graduate School
108
+```
109
+
110
+**Example:**
111
+```
112
+Grade 8.5: Understandable by average 8th grader
113
+Grade 12: High school senior level
114
+Grade 16: College graduate level
115
+```
116
+
117
+**Tips to Improve:**
118
+- Reduce sentence length
119
+- Use fewer complex words
120
+- Simplify sentence structure
121
+
122
+#### Automated Readability Index (ARI)
123
+
124
+**Scale:** 1-14+ (similar to grade levels)
125
+
126
+**Formula:**
127
+```
128
+4.71 × (characters/words) + 0.5 × (words/sentences) - 21.43
129
+```
130
+
131
+**Interpretation:**
132
+```
133
+1-6: Ages 5-12 (Elementary)
134
+7-9: Ages 12-15 (Middle School)
135
+10-12: Ages 15-18 (High School)
136
+13+: Ages 18+ (Adult)
137
+```
138
+
139
+---
140
+
141
+### Time Estimates
142
+
143
+#### Reading Time
144
+
145
+**Calculation:**
146
+```
147
+Words ÷ 200 words per minute = Reading time in minutes
148
+```
149
+
150
+**Example:**
151
+```
152
+1,000 words ÷ 200 = 5 minutes reading time
153
+```
154
+
155
+**Use cases:**
156
+- Blog posts
157
+- Articles
158
+- Documents
159
+- Emails
160
+
161
+#### Speaking Time
162
+
163
+**Calculation:**
164
+```
165
+Words ÷ 150 words per minute = Speaking time in minutes
166
+```
167
+
168
+**Example:**
169
+```
170
+1,000 words ÷ 150 = 6.67 minutes speaking time
171
+```
172
+
173
+**Use cases:**
174
+- Presentations
175
+- Speeches
176
+- Video scripts
177
+- Podcasts
178
+
179
+---
180
+
181
+### Vocabulary Analysis
182
+
183
+#### Unique Words
184
+
185
+**What it measures:** Number of different words used
186
+
187
+**Example:**
188
+```
189
+Text: "The cat sat on the mat. The cat was happy."
190
+Total words: 10
191
+Unique words: 7 (the, cat, sat, on, mat, was, happy)
192
+```
193
+
194
+#### Vocabulary Diversity
195
+
196
+**Calculation:**
197
+```
198
+(Unique Words ÷ Total Words) × 100 = Diversity %
199
+```
200
+
201
+**Interpretation:**
202
+```
203
+60%+: Excellent vocabulary
204
+50-59%: Good vocabulary
205
+40-49%: Average vocabulary
206
+30-39%: Limited vocabulary
207
+<30%: Very limited vocabulary
208
+```
209
+
210
+**Tips to Improve:**
211
+- Use synonyms
212
+- Vary word choice
213
+- Learn new words
214
+- Read diverse content
215
+
216
+#### Average Word Length
217
+
218
+**What it measures:** Mean characters per word
219
+
220
+**Interpretation:**
221
+```
222
+3-4 chars: Simple vocabulary
223
+4-5 chars: Average vocabulary
224
+5-6 chars: Advanced vocabulary
225
+6+ chars: Complex vocabulary
226
+```
227
+
228
+---
229
+
230
+## 📊 Viewing Statistics
231
+
232
+### Method 1: Extension Popup
233
+
234
+1. **Click Extension Icon**
235
+2. **Select Statistics Tab**
236
+3. **View Real-time Stats**
237
+
238
+**Displays:**
239
+- Word count
240
+- Reading time
241
+- Readability score
242
+- Issue breakdown
243
+
244
+### Method 2: Options Page
245
+
246
+1. **Right-click Extension → Options**
247
+2. **Navigate to Statistics**
248
+3. **View Detailed Analytics**
249
+
250
+**Displays:**
251
+- All metrics
252
+- Historical data
253
+- Trends over time
254
+
255
+### Method 3: Manual Check
256
+
257
+1. **Select Text**
258
+2. **Right-click → "Analyze with OpenGrammar"**
259
+3. **View Statistics Popup**
260
+
261
+---
262
+
263
+## 📈 Example Statistics Report
264
+
265
+```
266
+┌─────────────────────────────────────────┐
267
+│ Writing Statistics Report │
268
+├─────────────────────────────────────────┤
269
+│ │
270
+│ 📊 Basic Counts │
271
+│ ─────────────────────────────────────── │
272
+│ Words: 1,248 │
273
+│ Characters: 6,542 │
274
+│ Characters (no sp): 5,421 │
275
+│ Sentences: 87 │
276
+│ Paragraphs: 12 │
277
+│ Syllables: 1,876 │
278
+│ │
279
+│ 📖 Readability Scores │
280
+│ ─────────────────────────────────────── │
281
+│ Flesch Ease: 78.5 (Excellent) │
282
+│ Grade Level: 8.5 (Good) │
283
+│ ARI: 9.2 (Good) │
284
+│ Reading Level: 8th-9th grade │
285
+│ │
286
+│ ⏱️ Time Estimates │
287
+│ ─────────────────────────────────────── │
288
+│ Reading Time: 6 min 14 sec │
289
+│ Speaking Time: 8 min 19 sec │
290
+│ │
291
+│ 🔤 Vocabulary Analysis │
292
+│ ─────────────────────────────────────── │
293
+│ Unique Words: 542 │
294
+│ Vocabulary Diversity: 43.4% (Good) │
295
+│ Average Word Length: 4.8 characters │
296
+│ Long Words (>6): 156 │
297
+│ │
298
+│ ⚠️ Issue Breakdown │
299
+│ ─────────────────────────────────────── │
300
+│ Grammar Errors: 3 🔴 │
301
+│ Spelling Errors: 5 🔴 │
302
+│ Style Issues: 7 🔵 │
303
+│ Clarity Issues: 4 🟡 │
304
+│ Total Issues: 19 │
305
+│ │
306
+│ 📈 Overall Score │
307
+│ ─────────────────────────────────────── │
308
+│ Writing Quality: 85/100 (Very Good) │
309
+│ ████████████████████░░░░ │
310
+│ │
311
+└─────────────────────────────────────────┘
312
+```
313
+
314
+---
315
+
316
+## 🎯 Improving Your Statistics
317
+
318
+### Improve Readability
319
+
320
+**Goal:** Higher Flesch score (easier to read)
321
+
322
+**Strategies:**
323
+
324
+1. **Shorten Sentences**
325
+ ```
326
+ Before: "The report, which was compiled over several months
327
+ by a team of researchers who worked tirelessly,
328
+ contains important findings." (32 words)
329
+
330
+ After: "The report contains important findings. A team of
331
+ researchers compiled it over several months. They
332
+ worked tirelessly." (3 sentences, avg 8 words)
333
+ ```
334
+
335
+2. **Use Simpler Words**
336
+ ```
337
+ Before: "utilize, implement, facilitate, demonstrate"
338
+ After: "use, put in place, help, show"
339
+ ```
340
+
341
+3. **Break Up Paragraphs**
342
+ - One idea per paragraph
343
+ - 3-5 sentences max
344
+ - White space helps readability
345
+
346
+### Improve Vocabulary Diversity
347
+
348
+**Goal:** 50%+ diversity score
349
+
350
+**Strategies:**
351
+
352
+1. **Use Synonyms**
353
+ ```
354
+ Before: "The product is good. The product is useful.
355
+ The product is reliable."
356
+
357
+ After: "The product is excellent. It's practical and
358
+ dependable. This item serves its purpose well."
359
+ ```
360
+
361
+2. **Vary Sentence Structure**
362
+ ```
363
+ Before: "I went to the store. I bought milk. I came home."
364
+ After: "After going to the store and buying milk, I
365
+ returned home."
366
+ ```
367
+
368
+3. **Learn New Words**
369
+ - Read widely
370
+ - Keep a word journal
371
+ - Use a thesaurus
372
+ - Practice new vocabulary
373
+
374
+### Improve Sentence Length
375
+
376
+**Goal:** 15-20 words average
377
+
378
+**Strategies:**
379
+
380
+1. **Identify Long Sentences**
381
+ - Look for sentences >30 words
382
+ - Check for multiple clauses
383
+ - Find run-on sentences
384
+
385
+2. **Split Long Sentences**
386
+ ```
387
+ Before: "The conference, which was held in San Francisco
388
+ last month and attended by over 500 professionals
389
+ from various industries, was highly successful."
390
+
391
+ After: "The conference was held in San Francisco last
392
+ month. Over 500 professionals attended from various
393
+ industries. The event was highly successful."
394
+ ```
395
+
396
+3. **Vary Sentence Length**
397
+ - Mix short and long sentences
398
+ - Short for impact
399
+ - Long for detail
400
+ - Creates rhythm
401
+
402
+---
403
+
404
+## 📊 Tracking Progress
405
+
406
+### Set Goals
407
+
408
+**Example Goals:**
409
+```
410
+Week 1: Reduce average sentence length to 20 words
411
+Week 2: Improve Flesch score to 70+
412
+Week 3: Increase vocabulary diversity to 50%
413
+Week 4: Maintain 85+ overall score
414
+```
415
+
416
+### Monitor Trends
417
+
418
+**Track Over Time:**
419
+- Daily writing sessions
420
+- Weekly averages
421
+- Monthly improvements
422
+- Document comparisons
423
+
424
+### Compare Documents
425
+
426
+**Compare:**
427
+- Different writing styles
428
+- Various topics
429
+- Before/after edits
430
+- Your writing vs. professionals
431
+
432
+---
433
+
434
+## 💡 Tips for Specific Use Cases
435
+
436
+### Academic Writing
437
+
438
+**Target Metrics:**
439
+- Grade Level: 12-16
440
+- Flesch: 50-60
441
+- Sentence Length: 20-25 words
442
+- Vocabulary Diversity: 60%+
443
+
444
+**Tips:**
445
+- Technical terms are okay
446
+- Maintain clarity
447
+- Cite sources properly
448
+- Use formal tone
449
+
450
+### Business Writing
451
+
452
+**Target Metrics:**
453
+- Grade Level: 10-12
454
+- Flesch: 60-70
455
+- Sentence Length: 15-20 words
456
+- Vocabulary Diversity: 50%+
457
+
458
+**Tips:**
459
+- Be concise
460
+- Use active voice
461
+- Clear call-to-action
462
+- Professional tone
463
+
464
+### Blog Posts
465
+
466
+**Target Metrics:**
467
+- Grade Level: 8-10
468
+- Flesch: 70-80
469
+- Sentence Length: 15-18 words
470
+- Vocabulary Diversity: 45%+
471
+
472
+**Tips:**
473
+- Write conversationally
474
+- Use subheadings
475
+- Short paragraphs
476
+- Engaging tone
477
+
478
+### Social Media
479
+
480
+**Target Metrics:**
481
+- Grade Level: 6-8
482
+- Flesch: 80-90
483
+- Sentence Length: 10-15 words
484
+- Character Count: Platform limits
485
+
486
+**Tips:**
487
+- Be brief
488
+- Use emojis appropriately
489
+- Include hashtags
490
+- Engaging hooks
491
+
492
+---
493
+
494
+## 🆘 Troubleshooting
495
+
496
+### Problem: Scores Seem Wrong
497
+
498
+**Solutions:**
499
+- Check text selection (select all text)
500
+- Ensure proper sentence punctuation
501
+- Verify paragraph breaks
502
+- Try recalculating
503
+
504
+### Problem: Statistics Not Loading
505
+
506
+**Solutions:**
507
+- Refresh the page
508
+- Check extension is enabled
509
+- Verify backend connection
510
+- Clear browser cache
511
+
512
+### Problem: Metrics Inconsistent
513
+
514
+**Solutions:**
515
+- Different tools use different formulas
516
+- Focus on trends, not absolute numbers
517
+- Use OpenGrammar consistently
518
+- Compare with multiple tools
519
+
520
+---
521
+
522
+## 📚 Related Documentation
523
+
524
+- [Using OpenGrammar](09-using-opengrammar.md) - Complete user guide
525
+- [Tone Rewriting](10-tone-rewriting.md) - Improve writing style
526
+- [Grammar Rules](16-grammar-rules.md) - Understand errors
527
+
528
+---
529
+
530
+**Happy Writing! 📊**
531
+
532
+Use statistics to understand and improve your writing over time!
0
533