[doc] document magical assign
[doc] misc
[doc] document limitations of magical assignement