refactor to one folder mkdocs, full of symlinks. works well.

Author: SiyaoIsHiding

README.md

@@ -45,8 +45,8 @@ are multiple modules, all prefixed with `java-driver-`.
 Note that the query builder is now published as a separate artifact, you'll need to add the
 dependency if you plan to use it.
 
-Refer to each module's manual for more details ([core](/manual/core/README.md), [query
-builder](/manual/query_builder/README.md), [mapper](/manual/mapper/README.md)).
+Refer to each module's manual for more details ([core](manual/core/README.md), [query
+builder](manual/query_builder/README.md), [mapper](manual/mapper/README.md)).
 
 [org.apache.cassandra]: http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.apache.cassandra%22
 
@@ -73,7 +73,7 @@ See the [Cassandra error handling done right blog](https://www.datastax.com/blog
 
 ## Useful links
 
-* [Manual](/manual/README.md)
+* [Manual](manual/README.md)
 * [API docs]
 * Bug tracking: [JIRA]
 * [Mailing list]

build-doc.sh

@@ -12,19 +12,5 @@ mvn clean install -DskipTests # or guava-shaded can not be found
 # mvn javadoc:javadoc -pl core,query-builder,mapper-runtime
 mvn javadoc:aggregate
 
-
-for f in HOME-README.md faq-README.md upgrade-README.md; do
-  perl -pi -e 's/\]\(\.\.\/manual\//](manual\//g;
-               s/\]\(\.\.\/faq\//](faq\//g;
-               s/\]\(\.\.\/changelog\//](changelog\//g;' "$f"
-done
-
-
 # Build manual with API references
 mkdocs build # or `mkdocs serve` to preview
-
-for f in HOME-README.md faq-README.md upgrade-README.md; do
-  perl -pi -e 's/\]\(manual\//]\(..\/manual\//g;
-               s/\]\(faq\//]\(..\/faq\//g;
-               s/\]\(changelog\//]\(..\/changelog\//g;' "$f"
-done

faq/README.md

@@ -65,7 +65,7 @@ At any rate, `CompletionStage` has a `toCompletableFuture()` method. In current
 ### Where is `DowngradingConsistencyRetryPolicy` from driver 3?
 
 **As of driver 4.10, this retry policy was made available again as a built-in alternative to the 
-default retry policy**: see the [manual](manual/core/retries/README.md) to understand how to use it. 
+default retry policy**: see the [manual](../manual//core/retries/README.md) to understand how to use it. 
 For versions between 4.0 and 4.9 inclusive, there is no built-in equivalent of driver 3 
 `DowngradingConsistencyRetryPolicy`.
 
@@ -100,7 +100,7 @@ This ability is considered a misfeature and has been removed from driver 4.0 onw
 However, due to popular demand, cross-datacenter failover has been brought back to driver 4 in
 version 4.10.0.
 
-If you are using a driver version >= 4.10.0, read the [manual](manual/core/loadbalancing/README.md) to
+If you are using a driver version >= 4.10.0, read the [manual](../manual//core/load_balancing/README.md) to
 understand how to enable this feature; for driver versions < 4.10.0, this feature is simply not
 available.
 
@@ -109,7 +109,7 @@ available.
 The driver now uses Java 8's improved date and time API. CQL type `timestamp` is mapped to
 `java.time.Instant`, and the corresponding getter and setter are `getInstant` and `setInstant`.
 
-See [Temporal types](manual/core/temporal_types/README.md) for more details.
+See [Temporal types](../manual//core/temporal_types/README.md) for more details.
 
 ### Why do DDL queries have a higher latency than driver 3?
 
@@ -119,6 +119,6 @@ noticeably higher latency than driver 3 (about 1 second).
 This is because those queries are now *debounced*: the driver adds a short wait in an attempt to
 group multiple schema changes into a single metadata refresh. If you want to mitigate this, you can
 either adjust the debouncing settings, or group your schema updates while temporarily disabling the
-metadata; see the [performance](manual/core/performance/#debouncing/README.md) page.
+metadata; see the [performance](../manual//core/performance/README.md#debouncing) page.
 
 This only applies to DDL queries; DML statements (`SELECT`, `INSERT`...) are not debounced.

manual/HOME-README.md

@@ -27,6 +27,6 @@ values for all configuration options (in the sources, it can be found under
 See the [configuration](../README.md) page for more explanations.
 
 ```conf
-{% include 'core/configuration/reference.conf' %}
+{% include 'manual/core/configuration/reference/reference.conf' %}
 ```
 

manual/changelog-README.md

@@ -0,0 +1 @@
+../../../../core/src/main/resources/reference.conf

manual/core/configuration/reference.conf

@@ -400,7 +400,7 @@ more fine-grained control of what should be retried, and how, is required.
 [ReactiveRow.wasApplied]:           https://docs.datastax.com/en/drivers/java/4.17/com/datastax/dse/driver/api/core/cql/reactive/ReactiveRow.html#wasApplied--
 
 [built-in retry mechanism]: ../retries/README.md
-[request throttling]: ../throttling/
+[request throttling]: ../throttling/README.md
 
 [Managing concurrency in asynchronous query execution]: https://docs.datastax.com/en/devapp/doc/devapp/driverManagingConcurrency.html]
 [Publisher]: https://www.reactive-streams.org/reactive-streams-1.0.2-javadoc/org/reactivestreams/Publisher.html