trying to round out the configuration documentation (part un)