when:
        def documentationReference = Documentation.upgradeGuide(11, "section")

        then:
        def expectedUrl = DOCUMENTATION_REGISTRY.getDocumentationFor("upgrading_version_11", "section")
        documentationReference.getUrl() == expectedUrl
        documentationReference.getConsultDocumentationMessage() == "Consult the upgrading guide for further information: ${expectedUrl}"
    }

        succeeds 'checkDeps'
    }

    @ToBeFixedForConfigurationCache(because = "Task uses the Configuration API")
    def "understands project notations"() {

                "This is scheduled to be removed in Gradle 9.0. " +
                "Consult the upgrading guide for further information: " +
                "https://docs.gradle.org/current/userguide/upgrading_version_8.html#project_report_convention_deprecation"
        )
        succeeds("projectReport")
    }

        "Please use the getPermissions() method instead. " +
        "Consult the upgrading guide for further information: " +
        new DocumentationRegistry().getDocumentationFor("upgrading_version_8","unix_file_permissions_deprecated")

        Documentation.upgradeGuide(42, "bar")  | "https://docs.gradle.org/${GradleVersion.current().version}/userguide/upgrading_version_42.html#bar"
    }

                "Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_8.html#gradle_enterprise_extension_deprecated")
        executer.expectDeprecationWarning(

                    "This is scheduled to be removed in Gradle 9.0. " +
                    "Consult the upgrading guide for further information: ${BASE_URL}/userguide/upgrading_version_8.html#org_gradle_util_reports_deprecations"
            )

            runner.expectLegacyDeprecationWarningIf(
                versionNumber.major < 4,

        if (!GradleContextualExecuter.configCache) {

            "https://github.com/ben-manes/gradle-versions-plugin/pull/856"
        )

        def result = runner.build()

        then:

                "Remove testing of plugins published with Gradle < 6.0"
            )
            .forwardOutput()
            .build()

        then: