docs: expand KubernetesDependentResource example

Signed-off-by: Chris Laprun <[email protected]>

Author: metacosm

docs/content/en/docs/documentation/configuration.md

@@ -113,11 +113,9 @@ for this feature.
 
 ## DependentResource-level configuration
 
-It is possible to define custom annotations to configure custom `DependentResource` implementations. For example, the
-SDK provides the `@KubernetesDependent` annotation which allows configuring `KubernetesDependentResource` instance.
-
-In order to provide such a configuration mechanism for your own `DependentResource` implementations, they must be
-annotated with the `@Configured` annotation. This annotation defines 3 fields that tie everything together:
+It is possible to define custom annotations to configure custom `DependentResource` implementations. In order to provide
+such a configuration mechanism for your own `DependentResource` implementations, they must be annotated with the
+`@Configured` annotation. This annotation defines 3 fields that tie everything together:
 
 - `by`, which specifies which annotation class will be used to configure your dependents,
 - `with`, which specifies the class holding the configuration object for your dependents and
@@ -137,6 +135,28 @@ implement the `ConfiguredDependentResource` interface, parameterized with the an
 `@Configured` annotation `by` field. This interface is called by the framework to inject the configuration at the
 appropriate time and retrieve the configuration, if it's available.
 
+For example, `KubernetesDependentResource`, a core implementation that the framework provides, can be configured via the
+`@KubernetesDependent` annotation. This set up is configured as follows:
+
+```java
+
+@Configured(
+        by = KubernetesDependent.class,
+        with = KubernetesDependentResourceConfig.class,
+        converter = KubernetesDependentConverter.class)
+public abstract class KubernetesDependentResource<R extends HasMetadata, P extends HasMetadata>
+        extends AbstractEventSourceHolderDependentResource<R, P, InformerEventSource<R, P>>
+        implements ConfiguredDependentResource<KubernetesDependentResourceConfig<R>> {
+  // code omitted
+}
+```
+
+The `@Configured` annotation specifies that `KubernetesDependentResource` instances can be configured by using the
+`@KubernetesDependent` annotation, which gets converted into a `KubernetesDependentResourceConfig` object by a
+`KubernetesDependentConverter`. That configuration object is then injected by the framework in the
+`KubernetesDependentResource` instance, after it's been created, because the class implements the
+`ConfiguredDependentResource` interface, properly parameterized.
+
 For more information on how to use this feature, we recommend looking at how this mechanism is implemented for
 `KubernetesDependentResource` in the core framework, `SchemaDependentResource` in the samples or `CustomAnnotationDep`
 in the `BaseConfigurationServiceTest` test class.