Repository: micronaut-projects/micronaut-core
File: http-client-core/src/main/java/io/micronaut/http/client/annotation/Client.java (Java)

Code before:
     */
    @AliasFor(member = "value") // <2>
    String id() default "";
// end::value[]

    /**
     * The interface definition type. Use {@code DefinitionType.SERVER} type, if you want
     * to use controller interface to describe HTTP client. Use {@code DefinitionType.CLIENT} type,
     * if you want to use custom interface to describe HTTP client.
     *
     * @return The interface definition type
     * @since 4.8.0
     */
    @NonNull
    DefinitionType definitionType() default DefinitionType.CLIENT;

    /**
     * The base URI for the client. Only to be used in
     * conjunction with {@link #id()}.
     *
     * @return The base URI
     */
    String path() default "";

    /**
     * @return The type used to decode errors
     */
    Class<?> errorType() default JsonError.class;

    /**
     * @return The http client configuration bean to use
     */
    Class<? extends HttpClientConfiguration> configuration() default HttpClientConfiguration.class;

    /**
     * The HTTP version.
     *
     * @return The HTTP version of the client.
     * @deprecated There are now separate settings for HTTP and HTTPS connections. To configure
     * HTTP connections (e.g. for h2c), use {@link #plaintextMode}. To configure ALPN, set
     * {@link #alpnModes}.
     */
    @Deprecated
    HttpVersion httpVersion() default HttpVersion.HTTP_1_1;

    /**
     * The connection mode to use for <i>plaintext</i> (http as opposed to https) connections.
     * <br>
     * <b>Note: If {@link #httpVersion} is set, this setting is ignored!</b>
     *
     * @return The plaintext connection mode.

Review comment (suggestion):
```suggestion
 /**
     * The interface definition type. When set to {@link DefinitionType.SERVER} the {@link Produces} and {@link Consumes}
     * definition evaluated for each method of the interface will be reversed .
     *
     * <p>Whilst not necessarily recommended, there are scenarios like testing where it is useful to share a common interface between client and server and use the
     * interface to create a new client declarative client. The client typically needs to produce the content type accepted by the server and consume the content type
     * produced by the server. In this arrangement using the interface directly will not result in the correct behaviour.</p>
     *
     * <p>In this scenario you can set {@link DefinitionType} to {@link DefinitionType.SERVER} which will ensure the requests sent by the client use the content type declared by the {@link Consumes}
     *  annotation of the interface and that responses use the content type declared by the {@link Produces}.</p>
     *  
     * <p>The default behaviour is to use {@link DefinitionType.CLIENT} where the inverse of the above is true.</p>
     *
     * @return The interface definition type
     * @since 4.8.0
     * @see Consumes
     * @see Produces
     */
```

Code after:

    /**
     * @return The ID of the client
     */
    @AliasFor(member = "value") // <2>
    String id() default "";
// end::value[]

    /**
     * The interface definition type. When set to {@link DefinitionType.SERVER} the {@link Produces} and {@link Consumes}
     * definition evaluated for each method of the interface will be reversed .
     *
     * <p>Whilst not necessarily recommended, there are scenarios like testing where it is useful to share a common interface between client and server and use the
     * interface to create a new client declarative client. The client typically needs to produce the content type accepted by the server and consume the content type
     * produced by the server. In this arrangement using the interface directly will not result in the correct behaviour.</p>
     *
     * <p>In this scenario you can set {@link DefinitionType} to {@link DefinitionType.SERVER} which will ensure the requests sent by the client use the content type declared by the {@link Consumes}
     *  annotation of the interface and that responses use the content type declared by the {@link Produces}.</p>
     *
     * <p>The default behaviour is to use {@link DefinitionType.CLIENT} where the inverse of the above is true.</p>
     *
     * @return The interface definition type
     * @since 4.8.0
     * @see Consumes
     * @see Produces
     */
    @Experimental
    @NonNull
    DefinitionType definitionType() default DefinitionType.CLIENT;

    /**
     * The base URI for the client. Only to be used in
     * conjunction with {@link #id()}.
     *
     * @return The base URI
     */
    String path() default "";

    /**
     * @return The type used to decode errors
     */
    Class<?> errorType() default JsonError.class;

    /**
     * @return The http client configuration bean to use
     */
    Class<? extends HttpClientConfiguration> configuration() default HttpClientConfiguration.class;

    /**
     * The HTTP version.
     *