"summary" | "removalDetails" | "advice" | null               | null                                         | "summary removalDetails advice"
        "summary" | "removalDetails" | "advice" | "contextualAdvice" | null                                         | "summary removalDetails contextualAdvice advice"

        return removalDetails;
    }

    /**
     * General, non usage specific, advice on what to do about this notice.
     *
     * Example: Use method Foo.baz() instead.
     */
    @Nullable
    public String getAdvice() {
        return advice;
    }

    /**
     * Advice on what to do about the notice, specific to this usage.
     *

    private final String advice;
    private final String context;
    private final DocLink documentation;
    private final DeprecatedFeatureUsage.Type usageType;
    private final String problemIdDisplayName;
    private final String problemId;

    DeprecationMessage(
        String summary,
        String removalDetails,
        @Nullable String advice,
        @Nullable String context,

            this.contextualAdvice = contextualAdvice;
            return this;
        }

        @CheckReturnValue
        public Builder withAdvice(String advice) {
            this.advice = advice;
            return this;
        }

        @Override
        @CheckReturnValue
        public Builder withDocumentation(DocLink documentation) {
            this.documentation = documentation;

 * @since 8.6
 */
@Incubating
public interface Severity {

    // Note: the static fields must be in sync with entries from org.gradle.api.problems.Severity.
    /**
     * Advice-level severity.
     *
     * @since 8.6
     */
    Severity ADVICE = new DefaultSeverity(0, true);

    /**
     * Warning-level severity.
     *
     * @since 8.6
     */
    Severity WARNING = new DefaultSeverity(1, true);

    /**

 */

package org.gradle.api.problems;

import org.gradle.api.Incubating;

/**
 * A problem severity.
 *
 * @since 8.6
 */
@Incubating
public enum Severity {
    ADVICE("Advice"),
    WARNING("Warning"),
    ERROR("Error");
    private final String displayName;

    Severity(String displayName) {
        this.displayName = displayName;
    }

    @Override

    }

    @Override
    public boolean isKnown() {
        return known;
    }

    public static Severity from(int severity) {
        if (severity == Severity.ADVICE.getSeverity()) {
            return Severity.ADVICE;
        } else if (severity == Severity.WARNING.getSeverity()) {
            return Severity.WARNING;
        } else if (severity == Severity.ERROR.getSeverity()) {
            return Severity.ERROR;

 * actionable advice to avoid the problem.
 */
public interface RoleBasedConfigurationCreationRequest {
    /**
     * The default advice when a configuration is created with a reserved name.
     *
     * @param configurationName the name of the configuration being requested
     * @return the default advice for a deprecation warning related to this request
     */

        ) {
            DocumentedFailure.Builder builder = DocumentedFailure.builder();
            String advice = "Consider adding an additional attribute to one of the configurations to disambiguate them.";
            if (withTaskAdvice) {
                advice += "  Run the 'outgoingVariants' task for more details.";
            }

            definition.severity == Severity.WARNING
        }
    }

    def "notCompatibleWithConfigurationCache task problems are reported as Advice"() {
        given:
        buildFile """
            task run {
                notCompatibleWithConfigurationCache("because")
                doLast {
                    println(project.name)
                }