clear preprocessed docs cache and fix discovered broken links

CONTRIBUTING.md

@@ -4,7 +4,7 @@ Thank you for considering contributing to **dlt**! We appreciate your help in ma
 
 ## Table of Contents
 
-1. [Getting Started](#getting-started)
+1. [Getting Started](#intro)
 2. [Submitting Changes](#submitting-changes)
 3. [Adding or updating core dependencies](#adding-or-updating-core-dependencies)
 4. [Linting](#linting)

docs/website/docs/build-a-pipeline-tutorial.md

@@ -7,8 +7,7 @@ keywords: [getting started, quick start, basics]
 # Building data pipelines with `dlt`, from basic to advanced
 
 This in-depth overview will take you through the main areas of pipelining with `dlt`. Go to the
-related pages you are instead looking for the [quickstart](getting-started.md), or the
-[walkthroughs](walkthroughs).
+related pages you are instead looking for the [quickstart](./intro.md).
 
 ## Why build pipelines with `dlt`?
 

docs/website/docs/dlt-ecosystem/destinations/bigquery.md

@@ -362,7 +362,5 @@ bigquery_adapter(my_resource, partition="partition_column_name")
 my_resource = bigquery_adapter(my_resource, partition="partition_column_name")
 ```
 
-Refer to the [full API specification](../../api_reference/destinations/impl/bigquery/bigquery_adapter.md) for more details.
-
 <!--@@@DLT_TUBA bigquery-->
 

docs/website/docs/dlt-ecosystem/verified-sources/filesystem/basic.md

@@ -42,7 +42,7 @@ print(pipeline.last_trace.last_normalize_info)
 
 ### Prerequisites
 
-Please make sure the `dlt` library is installed. Refer to the [installation guide](../../../getting-started).
+Please make sure the `dlt` library is installed. Refer to the [installation guide](../../../intro).
 
 ### Initialize the filesystem source
 

docs/website/docs/dlt-ecosystem/verified-sources/rest_api/basic.md

@@ -68,7 +68,7 @@ Running this pipeline will create two tables in the DuckDB: `posts` and `comment
 
 ### Prerequisites
 
-Please make sure the `dlt` library is installed. Refer to the [installation guide](../../../getting-started).
+Please make sure the `dlt` library is installed. Refer to the [installation guide](../../../intro).
 
 ### Initialize the REST API source
 
@@ -309,7 +309,7 @@ A resource configuration is used to define a [dlt resource](../../../general-usa
 - `include_from_parent`: A list of fields from the parent resource to be included in the resource output. See the [resource relationships](#include-fields-from-the-parent-resource) section for more details.
 - `selected`: A flag to indicate if the resource is selected for loading. This could be useful when you want to load data only from child resources and not from the parent resource.
 
-You can also pass additional resource parameters that will be used to configure the dlt resource. See [dlt resource API reference](../../../api_reference/extract/decorators.md#resource) for more details.
+You can also pass additional resource parameters that will be used to configure the dlt resource. 
 
 ### Endpoint configuration
 

docs/website/docs/general-usage/schema.md

@@ -148,7 +148,7 @@ Postgres ignore it when creating tables.
 Variant columns are generated by a normalizer when it encounters data item with type that cannot be
 coerced in existing column. Please see our [`coerce_row`](https://github.com/dlt-hub/dlt/blob/7d9baf1b8fdf2813bcf7f1afe5bb3558993305ca/dlt/common/schema/schema.py#L205) if you are interested to see how internally it works.
 
-Let's consider our [getting started](../getting-started#quick-start) example with slightly different approach,
+Let's consider our [getting started](../intro) example with slightly different approach,
 where `id` is an integer type at the beginning
 
 ```py

docs/website/docs/tutorial/load-data-from-an-api.md

@@ -74,7 +74,7 @@ Load package 1692364844.460054 is LOADED and contains no failed jobs
 
 ### Explore the data
 
-To allow sneak peek and basic discovery you can take advantage of [built-in integration with Strealmit](reference/command-line-interface#show-tables-and-data-in-the-destination):
+To allow sneak peek and basic discovery you can take advantage of [built-in integration with Strealmit](../reference/command-line-interface#show-tables-and-data-in-the-destination):
 
 ```sh
 dlt pipeline quick_start show
@@ -558,7 +558,7 @@ That's it! Now you have a reusable source that can load data from any GitHub rep
 
 ## What’s next
 
-Congratulations on completing the tutorial! You've come a long way since the [getting started](../getting-started) guide. By now, you've mastered loading data from various GitHub API endpoints, organizing resources into sources, managing secrets securely, and creating reusable sources. You can use these skills to build your own pipelines and load data from any source.
+Congratulations on completing the tutorial! You've come a long way since the [getting started](../intro) guide. By now, you've mastered loading data from various GitHub API endpoints, organizing resources into sources, managing secrets securely, and creating reusable sources. You can use these skills to build your own pipelines and load data from any source.
 
 Interested in learning more? Here are some suggestions:
 1. You've been running your pipelines locally. Learn how to [deploy and run them in the cloud](../walkthroughs/deploy-a-pipeline/).

docs/website/tools/preprocess_docs.js

@@ -372,6 +372,7 @@ if (process.argv.includes("--watch")) {
       if (Date.now() - lastUpdate < 500) {
           return;
       }
+      fs.rmdirSync(MD_TARGET_DIR, {force: true, recursive: true})
       console.log('%s changed...', name);
       syncExamples();
       preprocess_docs();