Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New documentation to make it clearer! #73

Open
wants to merge 3 commits into
base: cansavvy/gi-handling
Choose a base branch
from

Conversation

cansavvy
Copy link
Collaborator

@cansavvy cansavvy commented Dec 5, 2024

Description

Adding docs everywhere about how things are handled and calculated! I think by writing this I have a better understanding too but this will need some review to make sure:

  1. It's clear
  2. It's accurate

Closes #72

Review request

Focus on just the changes in the README because the rest of the doc updates are mainly echoing what's in there. (I literally copied and pasted)

Type of change

  • Documentation update

@cansavvy
Copy link
Collaborator Author

cansavvy commented Dec 5, 2024

Overall readability score: 44.1 (🔴 -2.31)

File Readability
README.md 57.61 (🔴 -9.24)
View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File Readability FRE GF ARI CLI DCRS
README.md 57.61 49.15 11.31 14 11.66 6.54
  🔴 -9.24 🔴 -14.14 🔴 -0.93 🔴 -3.5 🔴 -0.93 🟢 +0.34

Averages:

  Readability FRE GF ARI CLI DCRS
Average 44.1 34.12 12.03 14.35 14.21 8.31
  🔴 -2.31 🔴 -3.54 🔴 -0.23 🔴 -0.88 🔴 -0.23 🟢 +0.09
View metric targets
Metric Range Ideal score
Flesch Reading Ease 100 (very easy read) to 0 (extremely difficult read) 60
Gunning Fog 6 (very easy read) to 17 (extremely difficult read) 8 or less
Auto. Read. Index 6 (very easy read) to 14 (extremely difficult read) 8 or less
Coleman Liau Index 6 (very easy read) to 17 (extremely difficult read) 8 or less
Dale-Chall Readability 4.9 (very easy read) to 9.9 (extremely difficult read) 6.9 or less

@cansavvy
Copy link
Collaborator Author

cansavvy commented Dec 5, 2024

File Readability
README.md 57.92 (🔴 -8.94)

Readability has gone down but that's because I added a lot of really needed information that includes equations. Honestly a 9 point decrease is not bad considering!

@cansavvy cansavvy changed the base branch from main to cansavvy/gi-handling December 5, 2024 16:09
@cansavvy
Copy link
Collaborator Author

@cansavvy TODO: Rearrange this a tad for readability purposes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update docs and make calculations crystal clear
2 participants