Reading Level

QName: f:reading-level

Indicates that a node should track the reading level of each text property.

Configuration

This feature does not require configuration.

Scores

Scores can be interpreted as shown in the table below.

Score School level Notes
100.00–90.00 5th grade Very easy to read. Easily understood by an average 11-year-old student.
90.0–80.0 6th grade Easy to read. Conversational English for consumers.
80.0–70.0 7th grade Fairly easy to read.
70.0–60.0 8th & 9th grade Plain English. Easily understood by 13- to 15-year-old students.
60.0–50.0 10th to 12th grade Fairly difficult to read.
50.0–30.0 College Difficult to read.
30.0–0.0 College graduate Very difficult to read. Best understood by university graduates.

See Flesch reading ease for more information.

Word Count Example

Suppose we have a content type (my:test) that looks like this:

{
    "_qname": "my:test",
    "_type": "d:type",
    "type": "object",    
    "properties":{
        "title": {
            "type": "string"
        },
        "text1": {
            "type": "string"
        },
        "text2": {
            "type": "string"
        },
        "text3": {
            "type": "string"
        }
    },
    "mandatoryFeatures": {
        "f:reading-level": {}
    }
}

Now we create a piece of content of this type. We set the following:

  • title -> Test
  • test1 -> This weekend was awesome! I went to the ring ceremony at the baseball field. They played the blue and orange world series. And I won a raffle to throw out the first pitch.
  • test2 -> In the story "The White Umbrella" there are two sisters and their mom and dad. The main theme of this story is to be grateful for what you have. This story contains jealousy and excitement. The family is poor and the mom gets a secret job. Shes too embarrassed to tell the kids and other people she knows.
  • test3 -> Sigmund Freud is responsible for the theory of each living creature having three psychic zones: the id, the ego and the superego. In Mary Shelley's novel, Frankenstein, the evolution of the monster's mind and psychic zones are seen as he experiences several new sensations and emotions.

When we save this content, you'll end up with something like this:

{
    "title": "Test",
    "test1": "This weekend was awesome! I went to the ring ceremony at the baseball field. They played the blue and orange world series. And I won a raffle to throw out the first pitch.",
    "test2": "In the story \"The White Umbrella\" there are two sisters and their mom and dad. The main theme of this story is to be grateful for what you have. This story contains jealousy and excitement. The family is poor and the mom gets a secret job. Shes too embarrassed to tell the kids and other people she knows.",
    "test3": "Sigmund Freud is responsible for the theory of each living creature having three psychic zones: the id, the ego and the superego.  In Mary Shelley's novel, Frankenstein, the evolution of the monster's mind and psychic zones are seen as he experiences several new sensations and emotions.",
    "_features": {
        ...,
        "f:reading-level": {
            "scores": {
                "title": 92.719,
                "test1": 87.102,
                "test2": 59.552,
                "test3": 44.871,
                "*": 71.061
            }
        }
    }
}