> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Meaning Directness

> Measure how literal or figurative a text's language is with the Conventionality evaluator, scoring text complexity for grades 3-12 informational text.

[Evaluator last updated August 27, 2026.](#evaluator-release-history)

<EarlyAccess isBreaking={false} />

## Overview

The Meaning Directness evaluator assesses how directly a text communicates its meaning. It analyzes whether language is literal and explicit or relies on figurative, abstract, or implied meaning that requires interpretation.

## At a glance

|                      |                                                                                                                                                                                                                                                              |
| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Supported grades** | 3–12                                                                                                                                                                                                                                                         |
| **Rubric**           | [Student Achievement Partners (SAP)](https://learnwithsap.org/) ↗'s [Qualitative Text Complexity Rubric for Informational Text](https://learnwithsap.b-cdn.net/app/uploads/2026/04/Qualitative-Text-Complexity-Rubric-Informational.pdf) ↗ (Conventionality) |
| **Model used**       | Gemini 3 Flash preview (`gemini-3-flash-preview`) with temperature of 0 <Note>The evaluator was built and validated using this specific model and temperature. Other configurations will produce different results and may have lower accuracy.</Note>       |

## Getting started

Follow the [Quickstart](/evaluators/getting-started/quickstart) to start using this evaluator:

| Access method             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Evaluators playground** | [View in Platform](https://platform.learningcommons.org/apps/evaluators/playground) ↗                                                                                                                                                                                                                                                                                                                                                                                           |
| **SDK**                   | [Python](https://github.com/learning-commons-org/evaluators/blob/main/sdks/python/src/learning_commons_evaluators/evaluators/conventionality.py) ↗ and [TypeScript](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/evaluators/text-complexity/ela-reading/meaning-directness.ts) ↗                                                                                                                                                            |
| **Other**                 | [Python notebook](https://github.com/learning-commons-org/evaluators/blob/main/evals/text-complexity/ela-reading/meaning-directness/example_notebook.ipynb) ↗<br /><br />Prompts: [`system.txt`](https://github.com/learning-commons-org/evaluators/blob/main/evals/text-complexity/ela-reading/meaning-directness/system.txt) ↗ and [`user.txt`](https://github.com/learning-commons-org/evaluators/blob/main/evals/text-complexity/ela-reading/meaning-directness/user.txt) ↗ |

## Inputs

| Input           | Description                                                                        | Required |
| :-------------- | :--------------------------------------------------------------------------------- | :------- |
| **Text**        | Informational text to evaluate<br />10 - 10,000 words (\< 1,200 words recommended) | Yes      |
| **Grade level** | Target student grade level                                                         | Yes      |

## Output

| Field                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Complexity score**            | <ul><li><strong>Slightly complex:</strong> Confirm generated text uses literal, grade-appropriate language<ul><li>Language is literal and explicit</li><li>Meaning is directly stated</li><li>Minimal use of abstract, symbolic, ironic, and/or figurative language</li><li>Almost entirely explicit, literal, and straightforward</li></ul></li><li><strong>Moderately complex:</strong> Check whether occasional figurative language fits instructional goals<ul><li>Mostly literal language with occasional figurative or implicit meaning</li><li>Occasional use of abstract, symbolic, ironic, and/or figurative language</li><li>Primarily explicit, literal and straightforward</li></ul></li><li><strong>Very complex:</strong> Plan scaffolding when figurative language is central to meaning<ul><li>Frequent figurative language or implied meaning requires interpretation</li><li>Frequent use of abstract, symbolic, ironic, and/or figurative language</li></ul></li><li><strong>Exceedingly complex:</strong> Flag texts that require heavy interpretive support before use<ul><li>Language relies heavily on abstraction, layered meaning, or sustained figurative expression</li><li>Pervasive use of abstract, symbolic, ironic, and/or figurative language</li></ul></li></ul> |
| **Reasoning**                   | Detailed explanation of the rating, citing specific features in the text and referencing the expert guardrails (e.g., noting if the text relies on abstract qualities/rhetorical idealization, if vocabulary/background knowledge demands make a literal text vague for the grade level, or if it is strictly concrete/procedural)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Meaning directness features** | Specific language features driving complexity (for example, idioms, metaphors, irony, or implicit meaning)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Grade context**               | How the meaning directness demands compare to general expectations for the provided target grade                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Instructional insights**      | Actionable pedagogical suggestions for scaffolding the meaning directness features in the classroom                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

## Evaluator release history

| Date            | Changed              |
| --------------- | -------------------- |
| August 27, 2026 | Minor prompt updates |
| March 20, 2026  | First release        |