public T withUserManual(String documentationId) {
            return withDocumentation(Documentation.userManual(documentationId));
        }

        /**
         * Output: See USER_MANUAL_URL for more details.
         */
        @CheckReturnValue
        public T withUserManual(String documentationId, String section) {
            return withDocumentation(Documentation.userManual(documentationId, section));
        }

    def "formats message for documentation id #documentationId, section #documentationSection"() {
        given:
        def documentationReference = Documentation.userManual(documentationId, documentationSection)

        expect:
        documentationReference.getConsultDocumentationMessage() == expectedUrl

        where:
        documentationId | documentationSection | expectedUrl

        display(SimpleMessage, 'dummy') {
            type(onType).property(onProperty)
            description(desc)
            reason(testReason)
            includeLink()
            documentationId("id")
            documentationSection("section")
        }.render()
    }

    String dummyValidationProblem(@DelegatesTo(value = SimpleMessage, strategy = Closure.DELEGATE_FIRST) Closure<?> spec) {

## Documentation automatique

Les schémas JSON de vos modèles seront intégrés au schéma OpenAPI global de votre application, et seront donc affichés dans la documentation interactive de l'API :

<img src="/img/tutorial/body/image01.png">

Et seront aussi utilisés dans chaque *opération de chemin* de la documentation utilisant ces modèles :

platforms/ide/ide-native/         @gradle/bt-ide-experience @gradle/bt-native-maintainers

# Documentation
platforms/documentation/docs/src/docs/                                                        @gradle/bt-devrel-education
platforms/documentation/docs/src/samples/                                                     @gradle/bt-devrel-education
platforms/documentation/docs/src/docs-asciidoctor-extensions-base/                            @gradle/bt-devrel-education

        then:
        pd1 != pd2
    }

    def static asdfManual = Documentation.userManual("asdf")


    ProblemDefinition createProblemDefinition(
        String label = "label",
        Severity severity = Severity.ERROR,
        Documentation documentation = asdfManual,
        List<String> solutions = ImmutableList.of(),
        String displayName = "display name"
    ) {

    private final DocLink documentation;
    private final String problemIdDisplayName;
    private final String problemId;

    private final Type type;

    public DeprecatedFeatureUsage(
        String summary,
        String removalDetails,
        @Nullable String advice,
        @Nullable String contextualAdvice,
        @Nullable DocLink documentation,
        Type type,

        this.context = context;
        this.documentation = documentation;
        this.usageType = usageType;
        this.problemIdDisplayName = problemIdDisplayName;
        this.problemId = problemId;
    }

    DeprecatedFeatureUsage toDeprecatedFeatureUsage(Class<?> calledFrom) {
        return new DeprecatedFeatureUsage(summary, removalDetails, advice, context, documentation, usageType, problemIdDisplayName, problemId, calledFrom);

/**
 * A link to a documentation page.
 * <p>
 * Subtypes can represent different parts of the gradle documentation, e.g. the DSL reference, the user guide, etc.
 */
public interface DocLink extends Serializable {

    /**
     * The URL to the documentation page.
     */
    String getUrl();

    /**
     * A message that tells the user to consult the documentation.

            .expectDeprecationWarning("The compileClasspathCopy configuration has been deprecated for consumption. This will fail with an error in Gradle 9.0. For more information, please refer to https://docs.gradle.org/${GradleVersion.current().version}/userguide/declaring_dependencies.html#sec:deprecated-configurations in the Gradle documentation.", issueUrl)