diff --git a/docs/examples/.dlt/example.secrets.toml b/docs/examples/archive/.dlt/example.secrets.toml
similarity index 100%
rename from docs/examples/.dlt/example.secrets.toml
rename to docs/examples/archive/.dlt/example.secrets.toml
diff --git a/docs/examples/README.md b/docs/examples/archive/README.md
similarity index 100%
rename from docs/examples/README.md
rename to docs/examples/archive/README.md
diff --git a/docs/examples/__init__.py b/docs/examples/archive/__init__.py
similarity index 100%
rename from docs/examples/__init__.py
rename to docs/examples/archive/__init__.py
diff --git a/docs/examples/_helpers.py b/docs/examples/archive/_helpers.py
similarity index 100%
rename from docs/examples/_helpers.py
rename to docs/examples/archive/_helpers.py
diff --git a/docs/examples/chess/.dlt/config.toml b/docs/examples/archive/chess/.dlt/config.toml
similarity index 100%
rename from docs/examples/chess/.dlt/config.toml
rename to docs/examples/archive/chess/.dlt/config.toml
diff --git a/docs/examples/chess/__init__.py b/docs/examples/archive/chess/__init__.py
similarity index 100%
rename from docs/examples/chess/__init__.py
rename to docs/examples/archive/chess/__init__.py
diff --git a/docs/examples/chess/chess.py b/docs/examples/archive/chess/chess.py
similarity index 100%
rename from docs/examples/chess/chess.py
rename to docs/examples/archive/chess/chess.py
diff --git a/docs/examples/chess/chess_dbt.py b/docs/examples/archive/chess/chess_dbt.py
similarity index 100%
rename from docs/examples/chess/chess_dbt.py
rename to docs/examples/archive/chess/chess_dbt.py
diff --git a/docs/examples/chess/dbt_transform/.gitignore b/docs/examples/archive/chess/dbt_transform/.gitignore
similarity index 100%
rename from docs/examples/chess/dbt_transform/.gitignore
rename to docs/examples/archive/chess/dbt_transform/.gitignore
diff --git a/docs/examples/chess/dbt_transform/analyses/.gitkeep b/docs/examples/archive/chess/dbt_transform/analyses/.gitkeep
similarity index 100%
rename from docs/examples/chess/dbt_transform/analyses/.gitkeep
rename to docs/examples/archive/chess/dbt_transform/analyses/.gitkeep
diff --git a/docs/examples/chess/dbt_transform/dbt_project.yml b/docs/examples/archive/chess/dbt_transform/dbt_project.yml
similarity index 100%
rename from docs/examples/chess/dbt_transform/dbt_project.yml
rename to docs/examples/archive/chess/dbt_transform/dbt_project.yml
diff --git a/docs/examples/chess/dbt_transform/macros/.gitkeep b/docs/examples/archive/chess/dbt_transform/macros/.gitkeep
similarity index 100%
rename from docs/examples/chess/dbt_transform/macros/.gitkeep
rename to docs/examples/archive/chess/dbt_transform/macros/.gitkeep
diff --git a/docs/examples/chess/dbt_transform/models/_dlt_loads.sql b/docs/examples/archive/chess/dbt_transform/models/_dlt_loads.sql
similarity index 100%
rename from docs/examples/chess/dbt_transform/models/_dlt_loads.sql
rename to docs/examples/archive/chess/dbt_transform/models/_dlt_loads.sql
diff --git a/docs/examples/chess/dbt_transform/models/load_ids.sql b/docs/examples/archive/chess/dbt_transform/models/load_ids.sql
similarity index 100%
rename from docs/examples/chess/dbt_transform/models/load_ids.sql
rename to docs/examples/archive/chess/dbt_transform/models/load_ids.sql
diff --git a/docs/examples/chess/dbt_transform/models/schema.yml b/docs/examples/archive/chess/dbt_transform/models/schema.yml
similarity index 100%
rename from docs/examples/chess/dbt_transform/models/schema.yml
rename to docs/examples/archive/chess/dbt_transform/models/schema.yml
diff --git a/docs/examples/chess/dbt_transform/models/sources.yml b/docs/examples/archive/chess/dbt_transform/models/sources.yml
similarity index 100%
rename from docs/examples/chess/dbt_transform/models/sources.yml
rename to docs/examples/archive/chess/dbt_transform/models/sources.yml
diff --git a/docs/examples/chess/dbt_transform/models/view_player_games.sql b/docs/examples/archive/chess/dbt_transform/models/view_player_games.sql
similarity index 100%
rename from docs/examples/chess/dbt_transform/models/view_player_games.sql
rename to docs/examples/archive/chess/dbt_transform/models/view_player_games.sql
diff --git a/docs/examples/chess/dbt_transform/packages.yml b/docs/examples/archive/chess/dbt_transform/packages.yml
similarity index 100%
rename from docs/examples/chess/dbt_transform/packages.yml
rename to docs/examples/archive/chess/dbt_transform/packages.yml
diff --git a/docs/examples/chess/dbt_transform/seeds/.gitkeep b/docs/examples/archive/chess/dbt_transform/seeds/.gitkeep
similarity index 100%
rename from docs/examples/chess/dbt_transform/seeds/.gitkeep
rename to docs/examples/archive/chess/dbt_transform/seeds/.gitkeep
diff --git a/docs/examples/chess/dbt_transform/snapshots/.gitkeep b/docs/examples/archive/chess/dbt_transform/snapshots/.gitkeep
similarity index 100%
rename from docs/examples/chess/dbt_transform/snapshots/.gitkeep
rename to docs/examples/archive/chess/dbt_transform/snapshots/.gitkeep
diff --git a/docs/examples/chess/dbt_transform/tests/.gitkeep b/docs/examples/archive/chess/dbt_transform/tests/.gitkeep
similarity index 100%
rename from docs/examples/chess/dbt_transform/tests/.gitkeep
rename to docs/examples/archive/chess/dbt_transform/tests/.gitkeep
diff --git a/docs/examples/credentials/.dlt/config.toml b/docs/examples/archive/credentials/.dlt/config.toml
similarity index 100%
rename from docs/examples/credentials/.dlt/config.toml
rename to docs/examples/archive/credentials/.dlt/config.toml
diff --git a/docs/examples/credentials/__init__.py b/docs/examples/archive/credentials/__init__.py
similarity index 100%
rename from docs/examples/credentials/__init__.py
rename to docs/examples/archive/credentials/__init__.py
diff --git a/docs/examples/credentials/explicit.py b/docs/examples/archive/credentials/explicit.py
similarity index 100%
rename from docs/examples/credentials/explicit.py
rename to docs/examples/archive/credentials/explicit.py
diff --git a/docs/examples/data/channels.json b/docs/examples/archive/data/channels.json
similarity index 100%
rename from docs/examples/data/channels.json
rename to docs/examples/archive/data/channels.json
diff --git a/docs/examples/data/demo_example.json b/docs/examples/archive/data/demo_example.json
similarity index 100%
rename from docs/examples/data/demo_example.json
rename to docs/examples/archive/data/demo_example.json
diff --git a/docs/examples/data/messages.json b/docs/examples/archive/data/messages.json
similarity index 100%
rename from docs/examples/data/messages.json
rename to docs/examples/archive/data/messages.json
diff --git a/docs/examples/data/rasa_trackers/2888158124550630_tracker.jsonl b/docs/examples/archive/data/rasa_trackers/2888158124550630_tracker.jsonl
similarity index 100%
rename from docs/examples/data/rasa_trackers/2888158124550630_tracker.jsonl
rename to docs/examples/archive/data/rasa_trackers/2888158124550630_tracker.jsonl
diff --git a/docs/examples/data/rasa_trackers/8629c904-0c26-4f0b-927b-14d48db43c28_tracker.jsonl b/docs/examples/archive/data/rasa_trackers/8629c904-0c26-4f0b-927b-14d48db43c28_tracker.jsonl
similarity index 100%
rename from docs/examples/data/rasa_trackers/8629c904-0c26-4f0b-927b-14d48db43c28_tracker.jsonl
rename to docs/examples/archive/data/rasa_trackers/8629c904-0c26-4f0b-927b-14d48db43c28_tracker.jsonl
diff --git a/docs/examples/data/singer_taps/csv_catalog.json b/docs/examples/archive/data/singer_taps/csv_catalog.json
similarity index 100%
rename from docs/examples/data/singer_taps/csv_catalog.json
rename to docs/examples/archive/data/singer_taps/csv_catalog.json
diff --git a/docs/examples/data/singer_taps/model_annotations.csv b/docs/examples/archive/data/singer_taps/model_annotations.csv
similarity index 100%
rename from docs/examples/data/singer_taps/model_annotations.csv
rename to docs/examples/archive/data/singer_taps/model_annotations.csv
diff --git a/docs/examples/data/singer_taps/tap_google_sheet.jsonl b/docs/examples/archive/data/singer_taps/tap_google_sheet.jsonl
similarity index 100%
rename from docs/examples/data/singer_taps/tap_google_sheet.jsonl
rename to docs/examples/archive/data/singer_taps/tap_google_sheet.jsonl
diff --git a/docs/examples/data/singer_taps/tap_hubspot.jsonl b/docs/examples/archive/data/singer_taps/tap_hubspot.jsonl
similarity index 100%
rename from docs/examples/data/singer_taps/tap_hubspot.jsonl
rename to docs/examples/archive/data/singer_taps/tap_hubspot.jsonl
diff --git a/docs/examples/dbt_run_jaffle.py b/docs/examples/archive/dbt_run_jaffle.py
similarity index 100%
rename from docs/examples/dbt_run_jaffle.py
rename to docs/examples/archive/dbt_run_jaffle.py
diff --git a/docs/examples/discord_iterator.py b/docs/examples/archive/discord_iterator.py
similarity index 100%
rename from docs/examples/discord_iterator.py
rename to docs/examples/archive/discord_iterator.py
diff --git a/docs/examples/examples/schemas/dlt_quickstart.schema.yaml b/docs/examples/archive/examples/schemas/dlt_quickstart.schema.yaml
similarity index 100%
rename from docs/examples/examples/schemas/dlt_quickstart.schema.yaml
rename to docs/examples/archive/examples/schemas/dlt_quickstart.schema.yaml
diff --git a/docs/examples/google_drive_csv.py b/docs/examples/archive/google_drive_csv.py
similarity index 100%
rename from docs/examples/google_drive_csv.py
rename to docs/examples/archive/google_drive_csv.py
diff --git a/docs/examples/google_sheets.py b/docs/examples/archive/google_sheets.py
similarity index 100%
rename from docs/examples/google_sheets.py
rename to docs/examples/archive/google_sheets.py
diff --git a/docs/examples/quickstart.py b/docs/examples/archive/quickstart.py
similarity index 100%
rename from docs/examples/quickstart.py
rename to docs/examples/archive/quickstart.py
diff --git a/docs/examples/rasa_example.py b/docs/examples/archive/rasa_example.py
similarity index 100%
rename from docs/examples/rasa_example.py
rename to docs/examples/archive/rasa_example.py
diff --git a/docs/examples/read_table.py b/docs/examples/archive/read_table.py
similarity index 100%
rename from docs/examples/read_table.py
rename to docs/examples/archive/read_table.py
diff --git a/docs/examples/restore_pipeline.py b/docs/examples/archive/restore_pipeline.py
similarity index 100%
rename from docs/examples/restore_pipeline.py
rename to docs/examples/archive/restore_pipeline.py
diff --git a/docs/examples/schemas/__init__.py b/docs/examples/archive/schemas/__init__.py
similarity index 100%
rename from docs/examples/schemas/__init__.py
rename to docs/examples/archive/schemas/__init__.py
diff --git a/docs/examples/schemas/discord.schema.yml b/docs/examples/archive/schemas/discord.schema.yml
similarity index 100%
rename from docs/examples/schemas/discord.schema.yml
rename to docs/examples/archive/schemas/discord.schema.yml
diff --git a/docs/examples/schemas/dlt_quickstart.schema.yaml b/docs/examples/archive/schemas/dlt_quickstart.schema.yaml
similarity index 100%
rename from docs/examples/schemas/dlt_quickstart.schema.yaml
rename to docs/examples/archive/schemas/dlt_quickstart.schema.yaml
diff --git a/docs/examples/schemas/hubspot.schema.yaml b/docs/examples/archive/schemas/hubspot.schema.yaml
similarity index 100%
rename from docs/examples/schemas/hubspot.schema.yaml
rename to docs/examples/archive/schemas/hubspot.schema.yaml
diff --git a/docs/examples/schemas/inferred_demo.schema.yml b/docs/examples/archive/schemas/inferred_demo.schema.yml
similarity index 100%
rename from docs/examples/schemas/inferred_demo.schema.yml
rename to docs/examples/archive/schemas/inferred_demo.schema.yml
diff --git a/docs/examples/singer_tap_example.py b/docs/examples/archive/singer_tap_example.py
similarity index 100%
rename from docs/examples/singer_tap_example.py
rename to docs/examples/archive/singer_tap_example.py
diff --git a/docs/examples/singer_tap_jsonl_example.py b/docs/examples/archive/singer_tap_jsonl_example.py
similarity index 100%
rename from docs/examples/singer_tap_jsonl_example.py
rename to docs/examples/archive/singer_tap_jsonl_example.py
diff --git a/docs/examples/sources/__init__.py b/docs/examples/archive/sources/__init__.py
similarity index 100%
rename from docs/examples/sources/__init__.py
rename to docs/examples/archive/sources/__init__.py
diff --git a/docs/examples/sources/google_sheets.py b/docs/examples/archive/sources/google_sheets.py
similarity index 100%
rename from docs/examples/sources/google_sheets.py
rename to docs/examples/archive/sources/google_sheets.py
diff --git a/docs/examples/sources/jsonl.py b/docs/examples/archive/sources/jsonl.py
similarity index 100%
rename from docs/examples/sources/jsonl.py
rename to docs/examples/archive/sources/jsonl.py
diff --git a/docs/examples/sources/rasa/__init__.py b/docs/examples/archive/sources/rasa/__init__.py
similarity index 100%
rename from docs/examples/sources/rasa/__init__.py
rename to docs/examples/archive/sources/rasa/__init__.py
diff --git a/docs/examples/sources/rasa/rasa.py b/docs/examples/archive/sources/rasa/rasa.py
similarity index 100%
rename from docs/examples/sources/rasa/rasa.py
rename to docs/examples/archive/sources/rasa/rasa.py
diff --git a/docs/examples/sources/rasa/rasa.schema.yaml b/docs/examples/archive/sources/rasa/rasa.schema.yaml
similarity index 100%
rename from docs/examples/sources/rasa/rasa.schema.yaml
rename to docs/examples/archive/sources/rasa/rasa.schema.yaml
diff --git a/docs/examples/sources/singer_tap.py b/docs/examples/archive/sources/singer_tap.py
similarity index 100%
rename from docs/examples/sources/singer_tap.py
rename to docs/examples/archive/sources/singer_tap.py
diff --git a/docs/examples/sources/sql_query.py b/docs/examples/archive/sources/sql_query.py
similarity index 100%
rename from docs/examples/sources/sql_query.py
rename to docs/examples/archive/sources/sql_query.py
diff --git a/docs/examples/sources/stdout.py b/docs/examples/archive/sources/stdout.py
similarity index 100%
rename from docs/examples/sources/stdout.py
rename to docs/examples/archive/sources/stdout.py
diff --git a/docs/examples/sync_schema_example.py b/docs/examples/archive/sync_schema_example.py
similarity index 100%
rename from docs/examples/sync_schema_example.py
rename to docs/examples/archive/sync_schema_example.py