Distributor developer guide (plus refactorings to the importer section)