docs: Mark AsyncApiDocket as not recommended (#45)

* docs: Mark AsyncApiDocket as not recommended

* Update configuration.md

---------

Co-authored-by: sam0r040 <[email protected]>

Author: timonback

docs/configuration/configuration.md

@@ -9,10 +9,10 @@ import CodeConfigurationAsyncApiDocket from '!!raw-loader!./snippets/_configurat
 
 # Configuration
 
-There are 2 ways to configure springwolf:
+There are 2 ways to configure springwolf which cannot be combined:
 
-1. `application.properties`, which is simple and should suit most use-cases
-2. `AsyncApiDocket`, which allows adding producers and consumers via code (and avoiding annotations)
+1. `application.properties`, which is simple and moves all configuration to this file and annotations
+2. (deprecated) `AsyncApiDocket`, which allows adding producers and consumers via code (instead of annotations)
 
 <Tabs>
   <TabItem value="application.properties" label="application.properties" default>
@@ -78,4 +78,4 @@ The following table contains additional properties that can be specified in the
 [identifier]: https://www.asyncapi.com/docs/reference/specification/v2.0.0#A2SIdString.
 [info]: https://www.asyncapi.com/docs/reference/specification/v2.0.0#infoObject.
 [server]: https://www.asyncapi.com/docs/reference/specification/v2.0.0#serversObject
-[default-content-type]: https://www.asyncapi.com/docs/reference/specification/v2.0.0#defaultContentTypeString
+[default-content-type]: https://www.asyncapi.com/docs/reference/specification/v2.0.0#defaultContentTypeString

docs/configuration/documenting-consumers.md

@@ -88,10 +88,10 @@ Associate this operation with kafka, see [operation-binding] for details.
 ```
 
 
-## Option 2: `ConsumerData`
+## Option 2: `ConsumerData` (deprecated)
 
-:::tip
-Use specific ConsumerData types `AmqpConsumerData` & `KafkaConsumerData` for protocol specific attributes
+:::note
+Must use configuration via `AsyncApiDocket` and cannot use `application.properties`.
 :::
 
 Below is an example of describing a Kafka consumer:
@@ -119,6 +119,10 @@ public AsyncApiDocket asyncApiDocket() {
 
 Multiple consumers can be configured by calling the `consumer()` method multiple times.
 
+:::tip
+Use specific ConsumerData types `AmqpConsumerData` & `KafkaConsumerData` for protocol specific attributes
+:::
+
 ### Channel Name
 
 The channel name (or topic name in case of Kafka) - this is the name that will be used to subscribe to messages to by the UI.

docs/configuration/documenting-producers.md

@@ -83,10 +83,10 @@ Associate this operation with kafka, see [operation-binding] for details.
 ```
 
 
-## Option 2: `ProducerData`
+## Option 2: `ProducerData` (deprecated)
 
-:::tip
-Use specific ProducerData types `AmqpProducerData` & `KafkaProducerData` for protocol specific attributes
+:::note
+Must use configuration via `AsyncApiDocket` and cannot use `application.properties`.
 :::
 
 Below is an example of describing a Kafka producer:
@@ -114,6 +114,10 @@ public AsyncApiDocket asyncApiDocket() {
 
 Multiple producers can be configured by calling the `producer()` method multiple times.
 
+:::tip
+Use specific ProducerData types `AmqpProducerData` & `KafkaProducerData` for protocol specific attributes
+:::
+
 ### Channel Name
 
 The channel name (or topic name in case of Kafka) - this is the name that will be used to publish messages to by the UI.