DOC: reference.conf and migration guide