X-Git-Url: http://nitlanguage.org

diff --git a/src/model/mdoc.nit b/src/model/mdoc.nit
index dd31547..2f8d045 100644
--- a/src/model/mdoc.nit
+++ b/src/model/mdoc.nit
@@ -26,12 +26,22 @@ class MDoc
 
 	# The entity where the documentation is originally attached to.
 	# This gives some context to resolve identifiers or to run examples.
-	var original_mentity: nullable MEntity writable = null
+	var original_mentity: nullable MEntity = null is writable
 end
 
 redef class MEntity
 	# The documentation associated to the entity
-	var mdoc: nullable MDoc writable
+	var mdoc: nullable MDoc is writable
+
+	# The documentation associated to the entity or their main nested entity.
+	#
+	# MProject fall-back to their root MGroup
+	# MGroup fall-back to their default_mmodule
+	# Other entities do not fall-back
+	#
+	# One may use `MDoc::original_mentity` to retrieve the original
+	# source of the documentation.
+	fun mdoc_or_fallback: nullable MDoc do return mdoc
 
 	# Is the entity deprecated?
 	#