diff --git a/code/common/model/src/main/java/nu/marginalia/model/idx/DocumentMetadata.java b/code/common/model/src/main/java/nu/marginalia/model/idx/DocumentMetadata.java
index f9853ab2..26794c32 100644
--- a/code/common/model/src/main/java/nu/marginalia/model/idx/DocumentMetadata.java
+++ b/code/common/model/src/main/java/nu/marginalia/model/idx/DocumentMetadata.java
@@ -17,7 +17,7 @@ import static java.lang.Math.min;
  * @param topology a measure of how important the document is
  * @param year encoded publishing year
  * @param sets bit mask for search sets
- * @param quality quality of the document
+ * @param quality quality of the document (0-15); 0 is best, 15 is worst
  * @param flags flags (see {@link DocumentFlags})
  */
 public record DocumentMetadata(int avgSentLength,