"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;

            definition.severity == Severity.WARNING
        }
    }

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

     */
    ProblemDefinition getDefinition();

    @Nullable
    String getContextualLabel();

    /**
     * Returns solutions and advice that contain context-sensitive data, e.g. the message contains references to variables, locations, etc.
     */
    List<String> getSolutions();

    /**
     * A long description detailing the problem.
     * <p>

        task.name in listOf(
            "graph", "graphMain",
            "projectGraphReport",
            "ripples",
            "aggregateAdvice",
        ) -> true
        task.name.startsWithAnyOf(
            "advice",
            "analyzeClassUsage",
            "analyzeJar",
            "constantUsageDetector",
            "createVariantFiles",
            "findUnusedProcs",
            "generalsUsageDetector",

        Map<String, Object> deprecation = new LinkedHashMap<String, Object>();
        deprecation.put("summary", getSummary());
        deprecation.put("removalDetails", getRemovalDetails());
        deprecation.put("advice", getAdvice());
        deprecation.put("contextualAdvice", getContextualAdvice());
        deprecation.put("documentationUrl", getDocumentationUrl());
        deprecation.put("type", getType());

== Annotation processors and Kotlin

The <<caching_java_projects.adoc#annotation_processors,advice above>> for pure Java projects also applies to Android projects.

# When we run 'go mod tidy -e', we should proceed past the first error and follow
# it with a second error describing the version discrepancy.
#
# We should not provide advice on how to push past the version discrepancy,
# because the '-e' flag should already do that, writing out an otherwise-tidied
# go.mod file.

go mod tidy -e