explain += fmt.Sprintf("; %s sets ", base.ShortPath(Startup.AutoFile))
		if Startup.AutoToolchain != "" {
			explain += "toolchain " + Startup.AutoToolchain
		} else {
			explain += "go " + Startup.AutoGoVersion
		}
	}
	return fmt.Sprintf("%v requires go >= %v (running go %v%v)", e.What, e.GoVersion, Local(), explain)
}

var ErrTooNew = errors.New("module too new")

package org.gradle.api.internal.specs;

import org.gradle.api.specs.Spec;

/**
 * A predicate against objects of type T that can explain the unsatisfied reason.
 *
 * @param <T> The target type for this Spec
 */
public interface ExplainingSpec<T> extends Spec<T> {

    /**
     * Explains why the spec is not satisfied.
     *
     * @param element candidate

        when:
        def ability = new FixedBuildAbility(false)

        then:
        !ability.buildable
    }

    def "explains not buildable reason" () {
        def visitor = Mock(DiagnosticsVisitor)

        when:
        def ability = new FixedBuildAbility(false)
        ability.explain(visitor)

        then:
        1 * visitor.node("Disabled by user")
    }

     * @param candidate The install dir to use. Can be null.
     * @return A result containing the best component, or an unavailable result that explains why the lookup failed
     */
    SearchResult<T> locateComponent(@Nullable File candidate);

    /**
     * Locates all available components. Does not explain why things were not found. This method is only used for testing.
     */
    List<? extends T> locateAllComponents();

====

And that's it! Now we have:

- added a variant which provides instrumented jars
- explained that this variant is a substitute for the runtime
- explained that the consumer needs this variant _only for test runtime_

Gradle therefore offers a powerful mechanism to select the right variants based on preferences and compatibility.

## Get started

In this document we will explain in detail on how to configure admin users.

### 1. Prerequisites

https://docs.gradle.com/build-scan-plugin/#getting_set_up[Build Scan Plugin User Manual]
explains how to enable build scans.

At the end of your build, Gradle displays a URL where you can find your build scan:

----
BUILD SUCCESSFUL in 2s
4 actionable tasks: 4 executed

Publishing build scan...
https://gradle.com/s/e6ircx2wjbf7e
----

This section explains how to profile your build with build scans.

== Profile with build scans

// license that can be found in the LICENSE file.

package main

type explainer struct {
	m map[string]string
}

func init() {
	RegisterExplainer(newExplainer())
}

type Explainer interface {
	Name() string
	Map() map[string]string
}

func (e explainer) Name() string {
	return "HelloWorldExplainer"
}

func (e explainer) Map() map[string]string {
	return e.m
}

//go:noinline

              NodeWith(Op("Placeholder"), Name("placeholder"), Inputs()));

  EXPECT_EQ(Explain(placeholder.node(), NodeWith(Op("Add"))),
            "\nexpected op Add but found Placeholder");
  EXPECT_EQ(Explain(placeholder.node(), NodeWith(Name("add"))),
            "\nexpected name add but found placeholder");
  EXPECT_EQ(Explain(placeholder.node(), NodeWith(Inputs(Out(NodeWith())))),
            "\nexpected 1 inputs but node has 0");
}

        when:
        availability.explain(visitor)

        then:
        1 * visitor.node("some reason")
    }

    def "visits message when unsupported"() {
        def visitor = Mock(DiagnosticsVisitor)

        given:
        def availability = new ToolChainAvailability()
        availability.unsupported("some reason")

        when:
        availability.explain(visitor)

        then: