build relations at installation-time, enhanced doc