/**
         * The total number of log files.
         */
        protected long total = 0;

        /**
         * Sets the list of log files.
         * @param files The list of log files.
         * @return This ApiLogFilesResponse instance.
         */
        public ApiLogFilesResponse files(final List<Map<String, Object>> files) {
            this.files = files;
            return this;
        }

        name: update languages
        entry: uv run ./scripts/docs.py update-languages
        files: ^docs/.*|scripts/docs\.py$
        pass_filenames: false

      - id: ensure-non-translated
        language: unsupported
        name: ensure non-translated files are not modified
        entry: uv run ./scripts/docs.py ensure-non-translated
        files: ^docs/(?!en/).*|^scripts/docs\.py$
        pass_filenames: false

            logger.warn("Failed to access system.properties.", e);
        }
    }

    /**
     * Writes log files from the log directory to the ZIP output stream.
     *
     * @param zos the ZIP output stream to write to
     * @param id the diagnostic ID for organizing files in the ZIP
     */
    protected void writeLogFiles(final ZipOutputStream zos, final String id) {

      - name: Store coverage files
        if: matrix.coverage == 'coverage'
        uses: actions/upload-artifact@v7
        with:
          name: coverage-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('**/coverage/.coverage.*') }}
          path: coverage
          include-hidden-files: true

  benchmark:
    needs:
      - changes

#### Required Files for Copyright Headers:

- Source code files (e.g., `.java`, `.kt`, `.groovy`).
- Documentation files, where applicable (e.g., `.adoc`, `.md`).

#### Exempt Files for Copyright Headers:

- Scripts critical to builds, CI, or deployment (e.g., `.kts`, `.groovy`).
- Auto-generated files (e.g., by code generators).
- Minor configuration files (e.g., `.gitignore`).

      - name: Upload Mimir logs
        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
        if: always()
        with:
          name: initial-mimir-logs
          include-hidden-files: true
          retention-days: 1
          path: |
            ~/.mimir/*.log

  full-build:
    needs: initial-build
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false

Host Name: /*pmb.hostname:orElse('Unknown')*/

--- Log Summary ---
Level: /*pmb.level*/
Total: /*pmb.count*/ event(s) in the last /*pmb.interval*/ seconds

--- Log Details ---
/*pmb.details*/

In fact, those blocks of code are not written inside the Markdown, they are Python files in the `./docs_src/` directory.

And those Python files are included/injected in the documentation when generating the site.

### Docs for tests

Most of the tests actually run against the example source files in the documentation.

This helps to make sure that:

* The documentation is up-to-date.

                    }
                    if (directory.exists() && directory.isDirectory()) {
                        final File[] files = directory.listFiles(File::isDirectory);
                        if (files != null) {
                            for (final File file : files) {
                                final String name = file.getName();
                                subPackages.add(name);

        Path filePath = ResourceUtil.getSitePath(path.replaceAll("\\.\\.+", StringUtil.EMPTY).replaceAll("/+", "/").split("/"));
        if (Files.isDirectory(filePath)) {
            filePath = filePath.resolve("index.html");
        }
        if (Files.exists(filePath)) {
            try (InputStream in = Files.newInputStream(filePath); ServletOutputStream out = response.getOutputStream()) {
                response.setStatus(HttpServletResponse.SC_OK);