!!! tip
    This is a low level extension point.

    If you only need to declare additional responses, a more convenient way to do it is with [Additional Responses in OpenAPI](additional-responses.md){.internal-link target=_blank}.

You can extend the OpenAPI schema for a *path operation* using the parameter `openapi_extra`.

### OpenAPI Extensions

plugins {
    id 'idea'
    id 'java-library'
}

// tag::mark-additional-sourcesets-as-test[]
sourceSets {
    intTest {
        java {
            srcDirs = ['src/integration']
        }
    }
}

idea {
    module {
        testSources.from(sourceSets.intTest.java.srcDirs)
    }
}

        and:
        outputs.noneRecompiled()

        where:
        testCase                       | headerDirs
        "extra header dir after"       | '"src/main/headers", "src/additional-headers"'
        "extra header dir before"      | '"src/additional-headers", "src/main/headers"'
        "replacement header dir after" | '"src/main/headers", "src/replacement-headers"'
    }

commands: [{
    executable: gradle
    args: check
    expected-output-file: checkTask.out
    allow-additional-output: true
    allow-disordered-output: true
},{
    executable: gradle
    args: run
    expected-output-file: runTask.out
    allow-additional-output: true
    allow-disordered-output: true

commands: [{
    executable: gradle
    args: check
    expected-output-file: checkTask.out
    allow-additional-output: true
    allow-disordered-output: true
},{
    executable: gradle
    args: run
    expected-output-file: runTask.out
    allow-additional-output: true
    allow-disordered-output: true

commands: [{
    executable: gradle
    args: check
    expected-output-file: checkTask.out
    allow-additional-output: true
    allow-disordered-output: true
},{
    executable: gradle
    args: run
    expected-output-file: runTask.out
    allow-additional-output: true
    allow-disordered-output: true

        val expectedGradleParams = """-PcommitId=%dep.Gradle_Release_Check_Stage_ReadyforNightly_Trigger.build.vcs.number%  "-PgitUserName=bot-teamcity" "-PgitUserEmail=******@****.***" $pluginPortalUrlOverride %additional.gradle.parameters%"""

        val checkReady = gradleStep(steps, 0)
        checkReady.assertTasks("prepReleaseNightly checkNeedToPromote")
        assertEquals(expectedGradleParams, checkReady.gradleParams)

        then:
        assertTransformed("root.blue", "root.additional.blue", "a.additional.blue", "a.jar")
        outputContains("files = [root.additional.blue.green, root.blue.green, a.jar.green, a.additional.blue.green]")
        outputContains("artifacts = [root.additional.blue.green (root.additional.blue), root.blue.green (root.blue), a.jar.green (project :a), a.additional.blue.green (a.additional.blue)]")

* [Official Gradle documentation](https://docs.gradle.org)
* [Spring Boot Gradle Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/2.2.1.RELEASE/gradle-plugin/reference/html/)

### Additional Links
These additional references should also help you:

	Kubeconfig file utilities.
	`)

	userKubeconfigLongDesc = cmdutil.LongDesc(`
	Output a kubeconfig file for an additional user.
	`)

	userKubeconfigExample = cmdutil.Examples(`
	# Output a kubeconfig file for an additional user named foo
	kubeadm kubeconfig user --client-name=foo

	# Output a kubeconfig file for an additional user named foo using a kubeadm config file bar
	kubeadm kubeconfig user --client-name=foo --config=bar
	`)
)