docs: add warning about fully qualified types in HasMany relations (#1803)

brendt · web-flow · commit 814ddd407719 · 2025-12-11T14:14:12.000+01:00
diff --git a/docs/1-essentials/03-database.md b/docs/1-essentials/03-database.md
@@ -219,6 +219,10 @@ final class Book
 }
 ```
 
+:::warning
+Relation types in docblocks must always be fully qualified, and not use short class names.
+:::
+
 Tempest will infer all the information it needs to build the right queries for you. However, there might be cases where property names and type information don't map one-to-one on your database schema. In that case you can use dedicated attributes to define relations.
 
 ### Relation attributes

Original file line number	Diff line number	Diff line change
`@@ -219,6 +219,10 @@ final class Book`
`219`	`219`	`}`
`220`	`220`	```
`221`	`221`
	`222`	`+:::warning`
	`223`	`+Relation types in docblocks must always be fully qualified, and not use short class names.`
	`224`	`+:::`
	`225`	`+`
`222`	`226`	`Tempest will infer all the information it needs to build the right queries for you. However, there might be cases where property names and type information don't map one-to-one on your database schema. In that case you can use dedicated attributes to define relations.`
`223`	`227`
`224`	`228`	`### Relation attributes`