String msgExpectation = getUsageExpectationMessage();

        DeprecationLogger.deprecate(msgDiscovery + msgExpectation)
            .withAdvice(RoleBasedConfigurationCreationRequest.getDefaultReservedNameAdvice(configurationName))
            .willBecomeAnErrorInGradle9()
            .withUserManual("authoring_maintainable_build_scripts", "sec:dont_anticipate_configuration_creation")
            .nagUser();
    }

     *
     * @param configurationName the name of the configuration being requested
     * @return the default advice for a deprecation warning related to this request
     */
    static String getDefaultReservedNameAdvice(String configurationName) {
        return String.format("Do not create a configuration with the name %s.", configurationName);
    }

    String getConfigurationName();
    ConfigurationRole getRole();

        }

        @Override
        public void failOnInabilityToMutateUsage() {
            List<String> resolutions = Lists.newArrayList(
                RoleBasedConfigurationCreationRequest.getDefaultReservedNameAdvice(getConfigurationName()),
                getUsageMutationAdvice());
            throw new UnmodifiableUsageException(getConfigurationName(), resolutions);
        }