*/
    private void flagIfReversed(File file, Map<File, List<Error>> errors, List<Snippet> snippets) {
        List<Snippet> pair = snippets.stream()
            .filter(s -> s.lang != Language.UNKNOWN)
            .limit(2)
            .toList();

        if (pair.size() == 2 &&
            pair.get(0).lang == Language.GROOVY &&
            pair.get(1).lang == Language.KOTLIN) {

      <fields>
        <field xml.listStyle="flat">
          <name>supplement</name>
          <version>1.0.0</version>
          <description>Snippets of POM xml files used to supplement the data model.</description>
          <association>
            <type>Supplement</type>
            <multiplicity>*</multiplicity>
          </association>
        </field>

 * This class manages highlighting parameters such as fragment size, number of fragments,
 * and highlighting type for displaying search query matches in result snippets.
 */
public class HighlightInfo {
    /** The highlighting type (e.g., plain, html). */
    private String type;
    /** The size of each highlighted fragment in characters. */
    private int fragmentSize;

abstract class IntegrationTestExtension {
    /**
     * If enabled, there will be a `GenerateAutoTestedSamplesTestTask` task
     * that generates a subclass of `AbstractAutoTestedSamplesTest` to
     * test all snippets embedded in javadoc with `class='autoTested'`.
     */
    abstract val generateDefaultAutoTestedSamplesTest: Property<Boolean>
    abstract val testJvmXmx: Property<String>

# Gradle
# ------
.gradle
/build
/*/build
/*/*/build
/*/*/*/build
/*/*/*/*/*/build
/**/docs/src/samples/**/build
/**/docs/src/snippets/**/build
/*/internal-android-performance-testing/build-android-libs
test-splits/
/gradle/verification-keyring.gpg

# Kotlin
# ------
.kotlin

# IDEA
# ----
!/.idea
/.idea/*

public abstract class UserManual {
    /**
     * The root of the user manual documentation.  This is the source of the adoc files.
     */
    public abstract DirectoryProperty getRoot();

    /**
     * Source of snippets that can be inserted into the user manual
     */
    public abstract DirectoryProperty getSnippets();

    /**
     * Source of samples that can be inserted into the user manual
     *
     */

     * The stylesheet directory used by the DSL reference documentation.
     */
    public abstract DirectoryProperty getStylesheetDirectory();

    /**
     * The stylesheet used by the DSL reference to highlight code snippets.
     */
    public abstract RegularFileProperty getHighlightStylesheet();

    /**
     * Resources to include with the generated documentation.
     */
    public abstract ConfigurableFileCollection getResources();

        // The actual daemon registry dir will be a subfolder using the name of the distribution.
        daemonRegistry = repoRoot().dir("build/daemon")
        gradleSnippetsDir = repoRoot().dir("platforms/documentation/docs/src/snippets") // TODO use dependency management
        distZipVersion = project.version.toString()
    }

    // Wire the different inputs for local distributions and repos that are declared by dependencies in the build scripts

        «««
        ... comme prévu.
        ... cela fonctionnerait :
        ... etc.
        D'autres ...
        La suite ...
        »»»

2) This does not apply in URLs, code blocks, and code snippets. Do not remove or add spaces there.

### Headings

1) Prefer translating headings using the infinitive form (as is common in the existing French docs): «Créer…», «Utiliser…», «Ajouter…».

/**
 * {@code ear} packaging plugins bindings provider for {@code default} lifecycle.
 */
@Named("ear")
@Singleton
public final class EarLifecycleMappingProvider extends AbstractLifecycleMappingProvider {
    // START SNIPPET: ear
    private static final String[] BINDINGS = {
        "generate-resources",
                "org.apache.maven.plugins:maven-ear-plugin:" + EAR_PLUGIN_VERSION + ":generate-application-xml",
        "process-resources",