docs: relationships - more readable
docs: added small chapter about conventions