Documented Datamodel usage with PHP Namespaces

I would tend to agree with @Zauberfisch, there is no harm in bringing important points into documentation where it is seen as useful even if they exist elsewhere - I would suggest doing both (mention it here AND have a link to dig deeper). I think we over you the DRY principle a bit too much in documentation. It works for code, but communication is a different beast.