diff --git a/app/views/documents/analysis/sections/_readability.html.erb b/app/views/documents/analysis/sections/_readability.html.erb index f2819a68..b0534e32 100644 --- a/app/views/documents/analysis/sections/_readability.html.erb +++ b/app/views/documents/analysis/sections/_readability.html.erb @@ -198,8 +198,8 @@
-
N-syllable words
- <%= column_chart analysis.n_syllable_words.map { |k, v| [k, v] } %> +
Number of N-syllable words
+ <%= column_chart(analysis.n_syllable_words.map { |k, v| [k, v] }, colors: ["#8f8"]) %>
@@ -213,7 +213,7 @@ pie_chart({ 'exactly once' => analysis.words_used_once_count, 'multiple times' => analysis.words_used_repeatedly_count - }) + }, colors: ["#ff0", "#0f0"]) %>
@@ -226,6 +226,17 @@ Why is this important? close +

+ The higher percentage of reused words you have, the more likely a reader will + be able to understand new words from context alone, as they'll have more instances + in which they can infer a meaning from that word's surroundings. +

+

+ Having a higher number of reused words can make text much easier to read and understand, + but a limited vocabularity may result in repetition and bland writing. Having a higher + number of unique words may indicate more effective word choice, but can also be indicative + of jargon. +

@@ -241,7 +252,7 @@ pie_chart({ 'simple words' => analysis.simple_words_count, 'complex words' => analysis.complex_words_count - }) + }, colors: ["#0f0", "#ff0"]) %>
@@ -254,6 +265,18 @@ Why is this important? close +

+ A complex word is a word made up of at least two morphemes. + Conversely, a simple word consists of only one. + For example, "bookishness" is a complex word with morphemes "book", "ish", and "ness"; + "active" is a simple word with just one morpheme: "active". +

+

+ Having a healthy mixture of simple and complex words is an important aspect of variety + in your writing. Replacing complex words with simple words can make your story easier + to understand, while replacing simple words with complex words can more efficiently + pack more context and information into the words you choose to use. +