===============================

Applying changes to packages that are vendored follows the considerations
written down at go.dev/s/release.

When the Go tree is open for development, a specific change may be pulled in
at any time that it is needed. During the release freeze, the bar for changes
in vendored packages is the same as it is for changes in non-vendored packages.

See src/README.vendor for information on loading vendored packages

     */
    public abstract DirectoryProperty getStagingRoot();

    /**
     * The final location to place all rendered documentation.
     */
    public abstract DirectoryProperty getDocumentationRenderedRoot();

    /**
     * The collection of rendered documentation.  This is everything laid out as it would be deployed/packaged.
     */

import java.io.File;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

/**
 * Takes a rendered release notes HTML file and decorates it with extra elements/content/links.
 */
@CacheableTask
public abstract class DecorateReleaseNotes extends DefaultTask {
    /**
     * The rendered HTML release notes that need decoration.
     */
    @InputFile
    @PathSensitive(PathSensitivity.NONE)

import org.gradle.api.provider.Property;

/**
 * Configuration for generating Dokka based Kotlin DSL docs.
 */
public abstract class KotlinDslReference {

    /**
     * The location of the final rendered Dokka content.
     */
    public abstract DirectoryProperty getRenderedDocumentation();

    /**
     * The Dokka version to use instead the default one Dokkatoo is configured with.

    /**
     * The location of the release notes assets
     */
    public abstract DirectoryProperty getReleaseNotesAssets();

    // TODO: Need staging root property too

    /**
     * The collection of rendered documentation.
     */
    public abstract RegularFileProperty getRenderedDocumentation();

     * the result.
     *
     * @param template a Groovy template
     * @param bindings parameters for the template
     * @return the rendered template
     */
    public static String render(String template, Map<String, Object> bindings) throws IOException {
        final StringWriter writer = new StringWriter();

        try {

     */
    public abstract DirectoryProperty getStagingRoot();

    public abstract RegularFileProperty getGeneratedMetaDataFile();

    /**
     * The fully rendered documentation with all of its necessary resources.
     */
    public abstract ConfigurableFileCollection getRenderedDocumentation();

    /**
     * The CSS file to style Javadocs with
     */
    public abstract RegularFileProperty getJavadocCss();

    /**
     * A collection of the final rendered Javaodcs
     */
    public abstract ConfigurableFileCollection getRenderedDocumentation();

            // Sanitize HTML to prevent XSS
            final String sanitizedHtml = htmlSanitizer.sanitize(html);

            if (logger.isDebugEnabled()) {
                logger.debug("Rendered markdown. inputLength={}, outputLength={}", markdown.length(), sanitizedHtml.length());
            }

            return sanitizedHtml;
        } catch (final Exception e) {