FAQ 11.45 Wrong dependency?. Fixes #22

Author: bnasslahsen

src/docs/asciidoc/faq.adoc

@@ -173,19 +173,29 @@ springdoc.packagesToScan=package1, package2
 
 ===  How can I map `Pageable` (spring-date-commons) object to correct URL-Parameter in Swagger UI?
 
-The projects that uses `spring-data` should add this dependency together with the `springdoc-openapi-ui` dependency:
-[source,xml]
+If you only want to enable the support of spring Pageable Type, you can just enable it using:
+
+[source,properties]
 ----
-<dependency>
-    <groupId>org.springdoc</groupId>
-    <artifactId>springdoc-openapi-data-rest</artifactId>
-    <version>latest.version</version>
-</dependency>
+springdoc.model-converters.pageable-converter.enabled=true
 ----
 
-* If you use Pageable in a GET HTTP method, you will have to declare the explicit mapping of Pageable fields as Query Params and add the @Parameter(hidden = true) Pageable pageable on your pageable parameter.
+* If you use Pageable in a GET HTTP method, you will have to declare the explicit mapping of Pageable fields as Query Params and add the `@Parameter(hidden = true) Pageable pageable` on your pageable parameter.
 * You should also, declare the annotation `@PageableAsQueryParam` provided by springdoc on the method level, or declare your own if need to define your custom description, defaultValue, ...
 * Since, v1.3.1 you can use as well `@ParameterObject` instead of `@PageableAsQueryParam` for HTTP `GET` methods.
+[source,java]
+----
+static {
+    getConfig().replaceParameterObjectWithClass(org.springframework.data.domain.Pageable.class, Pageable.class)
+            .replaceParameterObjectWithClass(org.springframework.data.domain.PageRequest.class, Pageable.class);
+}
+----
+
+NOTE: The property `springdoc.model-converters.pageable-converter.enabled` is only available since v1.5.11+
+
+TIP: The projects that uses `spring-boot-starter-data-rest` should add the following dependency `springdoc-openapi-data-rest` in combination with the `springdoc-openapi-ui`.
+This dependency handles the main previous points listed above.
+
 
 
 === How can I generate enums in the generated description?
@@ -456,14 +466,14 @@ public OpenAPI customOpenAPI() {
 springdoc.cache.disabled= true
 ----
 
-=== How can I expose the api-docs endpoints without using the `swagger-ui`?
+=== How can I expose the mvc api-docs endpoints without using the `swagger-ui`?
 * You should use the `springdoc-openapi-core` dependency only:
 
 [source,xml]
 ----
 <dependency>
   <groupId>org.springdoc</groupId>
-  <artifactId>springdoc-openapi-core</artifactId>
+  <artifactId>springdoc-openapi-webmvc-core</artifactId>
   <version>latest.version</version>
 </dependency>
 ----