Update app.py

app.py

@@ -78,7 +78,23 @@ def classify_and_score(
     target_dok: str,
     agg: str = "max"
 ) -> dict:
-    """Classify a question against Bloom’s and DOK targets and return guidance."""
+    """Classify a question against Bloom’s and DOK targets and return guidance.
+
+    Args:
+        question: The question text to evaluate for cognitive demand.
+        target_bloom: Target Bloom’s level or range. Accepts exact (e.g., "Analyze")
+            or plus form (e.g., "Apply+") meaning that level or higher.
+        target_dok: Target DOK level or range. Accepts exact (e.g., "DOK3")
+            or span (e.g., "DOK2-DOK3").
+        agg: Aggregation method over phrase similarities within a level
+            (choices: "mean", "max", "topk_mean").
+
+    Returns:
+        A dictionary with:
+            ok: True if both Bloom’s and DOK match the targets.
+            measured: Dict with best levels and per-level scores for Bloom’s and DOK.
+            feedback: Brief guidance describing how to adjust the question to hit targets.
+    """
     res = classify_levels_phrases(
         question,
         BLOOMS_PHRASES,