also add note about using `set_vendor()` for creating new ones. and misc. other cleanup
lots more to come yet, once the basic patterns are proven