## Decision

The *Build Tool Team* has decided to use Architectural Decision Records (aka ADR) to track decisions we want to follow.

The main logic with ADRs is to describe (architectural) decisions made:

* To provide best practices and solutions we (as the *build tool* team) want to promote.
* To avoid asking the same thing multiple times during code review.

/**
 * Authentication class for Apache HttpComponents 4.x (HC4).
 * This class provides methods to handle authentication details such as
 * authentication scope, credentials, and authentication scheme.
 *
 * <p>
 * It includes constructors to initialize these details and getter and setter
 * methods to access and modify them.
 * </p>
 *
 * <p>
 * Example usage:
 * </p>
 * <pre>
 * {@code

/**
 * Authentication class for Apache HttpComponents 5.x (HC5).
 * This class provides methods to handle authentication details such as
 * authentication scope, credentials, and authentication scheme.
 *
 * <p>
 * It includes constructors to initialize these details and getter and setter
 * methods to access and modify them.
 * </p>
 *
 * <p>
 * Example usage:
 * </p>
 * <pre>
 * {@code

                    logger.debug("Failed to parse {}", pager.requestedTimeRange, e);
                }
            }
        }
    }

    /**
     * Parses a date/time string and converts it to UTC timezone.
     *
     * @param value The date/time string to parse
     * @param formatter The date/time formatter to use
     * @return LocalDateTime in UTC timezone
     */

    /**
     * Stores a role type.
     * @param roleType The role type to store.
     */
    public void store(final RoleType roleType) {

        roleTypeBhv.insertOrUpdate(roleType, op -> {
            op.setRefreshPolicy(Constants.TRUE);
        });

    }

    /**
     * Deletes a role type.
     * @param roleType The role type to delete.
     */
    public void delete(final RoleType roleType) {

            println("Tests to be included:\n$content")
            IncludeTestClassProvider(readTestClasses(content))
        }
        parameters.excludeTestClasses.get().isNotBlank() -> {
            val content = parameters.repoRoot.file("test-splits/exclude-test-classes.properties").get().asFile.readText()
            println("Tests to be excluded:\n$content")

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *

                    If change was made on the `release` branch but hasn't yet been merged to `master`, merge `release` to `master`:
                    <span class="btn btn-info" role="button">Merge release to master</span>
                  </summary>
                  <div class="well">

    private static final String AES = "AES";

    /**
     * The algorithm to use for the cipher.
     * Default is Blowfish for backward compatibility.
     */
    protected String algorithm = BLOWFISH;

    /**
     * The transformation to use for the cipher when using Key objects.
     * Default is Blowfish to match the algorithm default.
     * <p>

     *
     * @param session the session to use, must not be {@code null}
     * @param artifactCoordinates the artifact coordinates whose version range should be resolved, must not be {@code null}
     * @param repositories the repositories to use, or {@code null} to use the session's repositories
     * @param nature the nature of repositories to query when resolving the version range, or {@code null} to use the default