/ scripts / validation / writing_issues.sh
writing_issues.sh
 1  #!/bin/bash
 2  set -euo pipefail
 3  
 4  echo "🔍 Checking for common writing issues..."
 5  
 6  # Check for passive voice indicators
 7  echo "Checking for passive voice..."
 8  grep -r "is being\|was being\|will be\|has been\|have been\|had been" docs/ --include="*.md" || true
 9  
10  # Check for weak words
11  echo -e "\nChecking for weak language..."
12  grep -r "very\|really\|quite\|rather\|somewhat\|pretty\|fairly" docs/ --include="*.md" || true
13  
14  # Check for unclear references
15  echo -e "\nChecking for unclear references..."
16  grep -r "this\|that\|these\|those" docs/ --include="*.md" | grep -v "this tutorial\|this guide\|this section" || true
17  
18  echo "✅ Writing issues check completed"