TelemetryDeck · winsmith · May 4, 2026 · May 4, 2026 · May 4, 2026 · May 4, 2026
diff --git a/.github/workflows/azure-static-web-apps-purple-bush-012fe8010.yml b/.github/workflows/azure-static-web-apps-purple-bush-012fe8010.yml
@@ -0,0 +1,58 @@
+name: Azure Static Web Apps CI/CD
+
+on:
+  push:
+    branches:
+      - feature/zensible
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+    branches:
+      - feature/zensible
+
+jobs:
+  build_and_deploy_job:
+    if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.action != 'closed')
+    runs-on: ubuntu-latest
+    name: Build and Deploy Job
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: true
+          lfs: false
+      - name: Replace TelemetryDeck App ID
+        env:
+          TELEMETRYDECK_APP_ID: ${{ secrets.TELEMETRYDECK_APP_ID }}
+        run: |
+          sed -i "s|#TELEMETRYDECK_APP_ID#|${TELEMETRYDECK_APP_ID}|g" overrides/partials/integrations/analytics/telemetrydeck.html
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: zensical build --clean
+      - name: Build And Deploy
+        id: builddeploy
+        uses: Azure/static-web-apps-deploy@v1
+        with:
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN_PURPLE_BUSH_012FE8010 }}
+          repo_token: ${{ secrets.GITHUB_TOKEN }} # Used for Github integrations (i.e. PR comments)
+          action: "upload"
+          ###### Repository/Build Configurations - These values can be configured to match your app requirements. ######
+          # For more information regarding Static Web App workflow configurations, please visit: https://aka.ms/swaworkflowconfig
+          app_location: "site"
+          api_location: ""
+          skip_app_build: true
+          skip_api_build: true
+          output_location: ""
+          ###### End of Repository/Build Configurations ######
+
+  close_pull_request_job:
+    if: github.event_name == 'pull_request' && github.event.action == 'closed'
+    runs-on: ubuntu-latest
+    name: Close Pull Request Job
+    steps:
+      - name: Close Pull Request
+        id: closepullrequest
+        uses: Azure/static-web-apps-deploy@v1
+        with:
+          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN_PURPLE_BUSH_012FE8010 }}
+          action: "close"
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -0,0 +1,29 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - master
+      - main
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v6
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: site
+      - uses: actions/deploy-pages@v5
+        id: deployment
diff --git a/docs.11tydata.js b/docs.11tydata.js
diff --git a/api/api-query-from-insight.md → docs/api/api-query-from-insight.md b/api/api-query-from-insight.md → docs/api/api-query-from-insight.md
@@ -6,11 +6,9 @@ description: Using the TelemetryDeck API, you can retrieve the query that is use
 lead: Using the TelemetryDeck API, you can retrieve the query that is used in an insight
 ---
 
-{% notewarning "Paid plans only" %}
+!!! warning "Paid plans only"
 
-API access — including retrieving an insight's query — is available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and you'll be able to generate a personal access token and use the API.
-
-{% endnotewarning %}
+    API access — including retrieving an insight's query — is available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and you'll be able to generate a personal access token and use the API.
 
 ## Authorization
 

diff --git a/api/api-run-query.md → docs/api/api-run-query.md b/api/api-run-query.md → docs/api/api-run-query.md
@@ -7,11 +7,9 @@ lead: Using the TelemetryDeck API, you can run a query and retrieve its results
 order: 2
 ---
 
-{% notewarning "Paid plans only" %}
+!!! warning "Paid plans only"
 
-API access — including running queries — is available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and you'll be able to generate a personal access token and run queries.
-
-{% endnotewarning %}
+    API access — including running queries — is available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and you'll be able to generate a personal access token and run queries.
 
 ## Authorization
 

diff --git a/api/api-token.md → docs/api/api-token.md b/api/api-token.md → docs/api/api-token.md
@@ -7,11 +7,9 @@ lead: To interact with the TelemetryDeck API, you need a personal access token (
 order: 1
 ---
 
-{% notewarning "Paid plans only" %}
+!!! warning "Paid plans only"
 
-Personal access tokens are available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and the feature will become available in the dashboard.
-
-{% endnotewarning %}
+    Personal access tokens are available on TelemetryDeck's paid plans. If your organization is on the free plan, upgrade your plan first and the feature will become available in the dashboard.
 
 ## Generating a Personal Access Token
 

diff --git a/api/api.json → docs/api/api.json b/api/api.json → docs/api/api.json
diff --git a/api/insights-reference.md → docs/api/insights-reference.md b/api/insights-reference.md → docs/api/insights-reference.md
diff --git a/api/signals-reference.md → docs/api/signals-reference.md b/api/signals-reference.md → docs/api/signals-reference.md
diff --git a/articles/anonymization-how-it-works.md → docs/articles/anonymization-how-it-works.md b/articles/anonymization-how-it-works.md → docs/articles/anonymization-how-it-works.md
diff --git a/articles/app-privacy-report.md → docs/articles/app-privacy-report.md b/articles/app-privacy-report.md → docs/articles/app-privacy-report.md
diff --git a/articles/app-tracking-transparency.md → docs/articles/app-tracking-transparency.md b/articles/app-tracking-transparency.md → docs/articles/app-tracking-transparency.md
diff --git a/articles/apple-app-privacy.md → docs/articles/apple-app-privacy.md b/articles/apple-app-privacy.md → docs/articles/apple-app-privacy.md
@@ -34,14 +34,12 @@ In the second screen, scroll down until you see the **Identifiers** section.
 
 In TelemetryDeck's **default mode**, with no user identifier specified, check the **Device ID** checkmark. This is what identifies individual users to TelemetryDeck.
 
-{% noteinfo "Other Types of Identifiers" %}
+!!! warning "Other Types of Identifiers"
 
-In case you use TelemetryDeck in a more advanced way where you supply a custom user identifier, you'll need to think about this for a second:
+    In case you use TelemetryDeck in a more advanced way where you supply a custom user identifier, you'll need to think about this for a second:
 
-- If you instead specify a User Identifier such as email address or username to TelemetryDeck, check instead the **User ID** checkmark. The identifier is only transmitted as a hash, but it still counts as a user identifier.
-- If you instead are purposefully disabling user tracking by handing the same string to TelemetryDeck for each user, you don't need to check any of the checkboxes in the **Identifiers** section.
-
-{% endnoteinfo %}
+    - If you instead specify a User Identifier such as email address or username to TelemetryDeck, check instead the **User ID** checkmark. The identifier is only transmitted as a hash, but it still counts as a user identifier.
+    - If you instead are purposefully disabling user tracking by handing the same string to TelemetryDeck for each user, you don't need to check any of the checkboxes in the **Identifiers** section.
 
 ### Usage Data
 

diff --git a/articles/articles.json → docs/articles/articles.json b/articles/articles.json → docs/articles/articles.json
diff --git a/...if-users-upgrade-to-latest-app-version.md → ...if-users-upgrade-to-latest-app-version.md b/...if-users-upgrade-to-latest-app-version.md → ...if-users-upgrade-to-latest-app-version.md
diff --git a/articles/create-custom-dashboards.md → docs/articles/create-custom-dashboards.md b/articles/create-custom-dashboards.md → docs/articles/create-custom-dashboards.md
diff --git a/articles/decide-to-drop-ios-version.md → docs/articles/decide-to-drop-ios-version.md b/articles/decide-to-drop-ios-version.md → docs/articles/decide-to-drop-ios-version.md
diff --git a/articles/documentation.md → docs/articles/documentation.md b/articles/documentation.md → docs/articles/documentation.md
@@ -79,16 +79,14 @@ Organizational tags like `docs` and `guides` are automatically applied. Use the
 - The experience level of the reader (`beginner`, `intermediate`, `advanced`)
 - The type of query (`filter`, `cohorts`, etc.)
 
-{% noteinfo "You don't need to add 'docs' and 'articles' as tags" %}
+!!! warning "You don't need to add 'docs' and 'articles' as tags"
 
-All markdown files in the `docs` repository automatically get the `docs` tag applied to them (by `docs.11tydata.js`). In addition, the respective directories apply their own tags as well:
+    All markdown files in the `docs` repository automatically get the `docs` tag applied to them (by `docs.11tydata.js`). In addition, the respective directories apply their own tags as well:
 
-- Files in the `intro` directory get the `intro` tag applied.
-- Files in the `guides` directory get the `guides` tag applied.
-- Files in the `articles` directory get the `articles` tag applied.
-- Files in the `api` directory get the `api` tag applied.
-
-{% endnoteinfo %}
+    - Files in the `intro` directory get the `intro` tag applied.
+    - Files in the `guides` directory get the `guides` tag applied.
+    - Files in the `articles` directory get the `articles` tag applied.
+    - Files in the `api` directory get the `api` tag applied.
 
 ### Order
 

diff --git a/articles/duration-signals.md → docs/articles/duration-signals.md b/articles/duration-signals.md → docs/articles/duration-signals.md
diff --git a/articles/grand-rename.md → docs/articles/grand-rename.md b/articles/grand-rename.md → docs/articles/grand-rename.md
diff --git a/articles/hosting-solutions.md → docs/articles/hosting-solutions.md b/articles/hosting-solutions.md → docs/articles/hosting-solutions.md
diff --git a/articles/how-to-funnel-insights.md → docs/articles/how-to-funnel-insights.md b/articles/how-to-funnel-insights.md → docs/articles/how-to-funnel-insights.md
diff --git a/articles/insights-about-daily-users.md → docs/articles/insights-about-daily-users.md b/articles/insights-about-daily-users.md → docs/articles/insights-about-daily-users.md
diff --git a/articles/insights-about-monthly-users.md → .../articles/insights-about-monthly-users.md b/articles/insights-about-monthly-users.md → .../articles/insights-about-monthly-users.md
diff --git a/articles/insights-about-referrers.md → docs/articles/insights-about-referrers.md b/articles/insights-about-referrers.md → docs/articles/insights-about-referrers.md
diff --git a/articles/insights-about-system-version.md → ...articles/insights-about-system-version.md b/articles/insights-about-system-version.md → ...articles/insights-about-system-version.md
diff --git a/articles/insights.md → docs/articles/insights.md b/articles/insights.md → docs/articles/insights.md
diff --git a/articles/invite-members-to-organization.md → ...rticles/invite-members-to-organization.md b/articles/invite-members-to-organization.md → ...rticles/invite-members-to-organization.md
diff --git a/articles/login-options.md → docs/articles/login-options.md b/articles/login-options.md → docs/articles/login-options.md
diff --git a/articles/making-account.md → docs/articles/making-account.md b/articles/making-account.md → docs/articles/making-account.md
diff --git a/articles/namespaces.md → docs/articles/namespaces.md b/articles/namespaces.md → docs/articles/namespaces.md
diff --git a/articles/navigation-signals.md → docs/articles/navigation-signals.md b/articles/navigation-signals.md → docs/articles/navigation-signals.md
diff --git a/articles/notebooks.md → docs/articles/notebooks.md b/articles/notebooks.md → docs/articles/notebooks.md
diff --git a/articles/preset-errors.md → docs/articles/preset-errors.md b/articles/preset-errors.md → docs/articles/preset-errors.md
diff --git a/articles/preset-purchases.md → docs/articles/preset-purchases.md b/articles/preset-purchases.md → docs/articles/preset-purchases.md
diff --git a/articles/set-up-filters-insights.md → docs/articles/set-up-filters-insights.md b/articles/set-up-filters-insights.md → docs/articles/set-up-filters-insights.md
diff --git a/articles/signal-type-naming.md → docs/articles/signal-type-naming.md b/articles/signal-type-naming.md → docs/articles/signal-type-naming.md
diff --git a/articles/telemetry-client.md → docs/articles/telemetry-client.md b/articles/telemetry-client.md → docs/articles/telemetry-client.md
diff --git a/articles/test-mode.md → docs/articles/test-mode.md b/articles/test-mode.md → docs/articles/test-mode.md
diff --git a/articles/update-package.md → docs/articles/update-package.md b/articles/update-package.md → docs/articles/update-package.md
diff --git a/images/MAU_1.png → docs/assets/MAU_1.png b/images/MAU_1.png → docs/assets/MAU_1.png
diff --git a/images/MAU_2.png → docs/assets/MAU_2.png b/images/MAU_2.png → docs/assets/MAU_2.png
diff --git a/images/MAU_3.png → docs/assets/MAU_3.png b/images/MAU_3.png → docs/assets/MAU_3.png
diff --git a/images/MAU_4.png → docs/assets/MAU_4.png b/images/MAU_4.png → docs/assets/MAU_4.png
diff --git a/images/MAU_5.png → docs/assets/MAU_5.png b/images/MAU_5.png → docs/assets/MAU_5.png
diff --git a/images/Notebooks-Overview.png → docs/assets/Notebooks-Overview.png b/images/Notebooks-Overview.png → docs/assets/Notebooks-Overview.png
diff --git a/images/Notebooks-TQL-Live-Preview.png → docs/assets/Notebooks-TQL-Live-Preview.png b/images/Notebooks-TQL-Live-Preview.png → docs/assets/Notebooks-TQL-Live-Preview.png
diff --git a/images/Peerigon_Logo_RGB_no_padding.svg → docs/assets/Peerigon_Logo_RGB_no_padding.svg b/images/Peerigon_Logo_RGB_no_padding.svg → docs/assets/Peerigon_Logo_RGB_no_padding.svg
diff --git a/images/Referrers_1.png → docs/assets/Referrers_1.png b/images/Referrers_1.png → docs/assets/Referrers_1.png
diff --git a/images/Referrers_2.png → docs/assets/Referrers_2.png b/images/Referrers_2.png → docs/assets/Referrers_2.png
diff --git a/images/Referrers_3a.png → docs/assets/Referrers_3a.png b/images/Referrers_3a.png → docs/assets/Referrers_3a.png
diff --git a/images/Referrers_3b.png → docs/assets/Referrers_3b.png b/images/Referrers_3b.png → docs/assets/Referrers_3b.png
diff --git a/images/Referrers_4.png → docs/assets/Referrers_4.png b/images/Referrers_4.png → docs/assets/Referrers_4.png
diff --git a/images/Referrers_5.png → docs/assets/Referrers_5.png b/images/Referrers_5.png → docs/assets/Referrers_5.png
diff --git a/images/Screenshot_SystemVersion.png → docs/assets/Screenshot_SystemVersion.png b/images/Screenshot_SystemVersion.png → docs/assets/Screenshot_SystemVersion.png
diff --git a/images/aarrr-framework.png → docs/assets/aarrr-framework.png b/images/aarrr-framework.png → docs/assets/aarrr-framework.png
diff --git a/images/acquisition-active-vs-new.png → docs/assets/acquisition-active-vs-new.png b/images/acquisition-active-vs-new.png → docs/assets/acquisition-active-vs-new.png
diff --git a/images/acquisition-by-time-last-weeks.png → ...assets/acquisition-by-time-last-weeks.png b/images/acquisition-by-time-last-weeks.png → ...assets/acquisition-by-time-last-weeks.png
diff --git a/images/acquisition-by-time.png → docs/assets/acquisition-by-time.png b/images/acquisition-by-time.png → docs/assets/acquisition-by-time.png
diff --git a/images/acquisition-device-distribution.png → ...ssets/acquisition-device-distribution.png b/images/acquisition-device-distribution.png → ...ssets/acquisition-device-distribution.png
diff --git a/...s/acquisition-geographic-distribution.png → ...s/acquisition-geographic-distribution.png b/...s/acquisition-geographic-distribution.png → ...s/acquisition-geographic-distribution.png
diff --git a/images/acquisition-new-users.png → docs/assets/acquisition-new-users.png b/images/acquisition-new-users.png → docs/assets/acquisition-new-users.png
diff --git a/images/activation-activated-users.png → docs/assets/activation-activated-users.png b/images/activation-activated-users.png → docs/assets/activation-activated-users.png
diff --git a/images/activation-by-time.png → docs/assets/activation-by-time.png b/images/activation-by-time.png → docs/assets/activation-by-time.png
diff --git a/images/activation-device-distribution.png → ...assets/activation-device-distribution.png b/images/activation-device-distribution.png → ...assets/activation-device-distribution.png
diff --git a/...es/activation-geographic-distribution.png → ...ts/activation-geographic-distribution.png b/...es/activation-geographic-distribution.png → ...ts/activation-geographic-distribution.png
diff --git a/images/anonymization-display-image.jpg → docs/assets/anonymization-display-image.jpg b/images/anonymization-display-image.jpg → docs/assets/anonymization-display-image.jpg
diff --git a/images/bar-chart.PNG → docs/assets/bar-chart.PNG b/images/bar-chart.PNG → docs/assets/bar-chart.PNG
diff --git a/images/compact_wide_mode.PNG → docs/assets/compact_wide_mode.PNG b/images/compact_wide_mode.PNG → docs/assets/compact_wide_mode.PNG
diff --git a/images/create-new-insight.png → docs/assets/create-new-insight.png b/images/create-new-insight.png → docs/assets/create-new-insight.png
diff --git a/images/daily-active-users-example.png → docs/assets/daily-active-users-example.png b/images/daily-active-users-example.png → docs/assets/daily-active-users-example.png
diff --git a/images/dashboard-acquisition.png → docs/assets/dashboard-acquisition.png b/images/dashboard-acquisition.png → docs/assets/dashboard-acquisition.png
diff --git a/images/dashboard-custom.png → docs/assets/dashboard-custom.png b/images/dashboard-custom.png → docs/assets/dashboard-custom.png
diff --git a/images/dashboard-exploring-details.png → docs/assets/dashboard-exploring-details.png b/images/dashboard-exploring-details.png → docs/assets/dashboard-exploring-details.png
diff --git a/images/dashboard-filtering-data.png → docs/assets/dashboard-filtering-data.png b/images/dashboard-filtering-data.png → docs/assets/dashboard-filtering-data.png
diff --git a/images/dashboard-main-nav.png → docs/assets/dashboard-main-nav.png b/images/dashboard-main-nav.png → docs/assets/dashboard-main-nav.png
diff --git a/images/dashboard-notebooks.png → docs/assets/dashboard-notebooks.png b/images/dashboard-notebooks.png → docs/assets/dashboard-notebooks.png
diff --git a/images/dashboard-overview.png → docs/assets/dashboard-overview.png b/images/dashboard-overview.png → docs/assets/dashboard-overview.png
diff --git a/images/dashboard-signal-types.png → docs/assets/dashboard-signal-types.png b/images/dashboard-signal-types.png → docs/assets/dashboard-signal-types.png
diff --git a/images/display_mode.PNG → docs/assets/display_mode.PNG b/images/display_mode.PNG → docs/assets/display_mode.PNG
diff --git a/images/donut-chart.PNG → docs/assets/donut-chart.PNG b/images/donut-chart.PNG → docs/assets/donut-chart.PNG
diff --git a/images/duration-signal-01.png → docs/assets/duration-signal-01.png b/images/duration-signal-01.png → docs/assets/duration-signal-01.png
diff --git a/images/duration-signal-02.png → docs/assets/duration-signal-02.png b/images/duration-signal-02.png → docs/assets/duration-signal-02.png
diff --git a/images/duration-signal-03.png → docs/assets/duration-signal-03.png b/images/duration-signal-03.png → docs/assets/duration-signal-03.png
diff --git a/images/edit-dashboard-name.png → docs/assets/edit-dashboard-name.png b/images/edit-dashboard-name.png → docs/assets/edit-dashboard-name.png
diff --git a/images/faq.jpg → docs/assets/faq.jpg b/images/faq.jpg → docs/assets/faq.jpg
diff --git a/docs/assets/favicon.svg b/docs/assets/favicon.svg
diff --git a/images/filter_example.png → docs/assets/filter_example.png b/images/filter_example.png → docs/assets/filter_example.png
diff --git a/images/filter_location.png → docs/assets/filter_location.png b/images/filter_location.png → docs/assets/filter_location.png
diff --git a/images/funnel_type.PNG → docs/assets/funnel_type.PNG b/images/funnel_type.PNG → docs/assets/funnel_type.PNG
diff --git a/images/funnels_example.png → docs/assets/funnels_example.png b/images/funnels_example.png → docs/assets/funnels_example.png
diff --git a/images/funnels_set_filters.jpg → docs/assets/funnels_set_filters.jpg b/images/funnels_set_filters.jpg → docs/assets/funnels_set_filters.jpg
diff --git a/images/line-chart.PNG → docs/assets/line-chart.PNG b/images/line-chart.PNG → docs/assets/line-chart.PNG
diff --git a/images/location-create-dashboard.png → docs/assets/location-create-dashboard.png b/images/location-create-dashboard.png → docs/assets/location-create-dashboard.png
diff --git a/images/location-edit-group.PNG → docs/assets/location-edit-group.PNG b/images/location-edit-group.PNG → docs/assets/location-edit-group.PNG
diff --git a/images/location-edit-insight.png → docs/assets/location-edit-insight.png b/images/location-edit-insight.png → docs/assets/location-edit-insight.png
diff --git a/images/login-mask.png → docs/assets/login-mask.png b/images/login-mask.png → docs/assets/login-mask.png
diff --git a/docs/assets/logo.svg b/docs/assets/logo.svg
diff --git a/images/metrics-accessibility.png → docs/assets/metrics-accessibility.png b/images/metrics-accessibility.png → docs/assets/metrics-accessibility.png
diff --git a/images/metrics-devices.png → docs/assets/metrics-devices.png b/images/metrics-devices.png → docs/assets/metrics-devices.png
diff --git a/images/metrics-errors.png → docs/assets/metrics-errors.png b/images/metrics-errors.png → docs/assets/metrics-errors.png
diff --git a/images/metrics-localization.png → docs/assets/metrics-localization.png b/images/metrics-localization.png → docs/assets/metrics-localization.png
diff --git a/images/metrics-versions.png → docs/assets/metrics-versions.png b/images/metrics-versions.png → docs/assets/metrics-versions.png
diff --git a/images/notebooks-video-thumbnail.png → docs/assets/notebooks-video-thumbnail.png b/images/notebooks-video-thumbnail.png → docs/assets/notebooks-video-thumbnail.png
diff --git a/images/privacy-overview.png → docs/assets/privacy-overview.png b/images/privacy-overview.png → docs/assets/privacy-overview.png
diff --git a/images/purchases-privacy-box.png → docs/assets/purchases-privacy-box.png b/images/purchases-privacy-box.png → docs/assets/purchases-privacy-box.png
diff --git a/images/rc-td-1.png → docs/assets/rc-td-1.png b/images/rc-td-1.png → docs/assets/rc-td-1.png
diff --git a/images/rc-td-2.png → docs/assets/rc-td-2.png b/images/rc-td-2.png → docs/assets/rc-td-2.png
diff --git a/images/retention-by-time.png → docs/assets/retention-by-time.png b/images/retention-by-time.png → docs/assets/retention-by-time.png
diff --git a/images/retention-device-distribution.png → .../assets/retention-device-distribution.png b/images/retention-device-distribution.png → .../assets/retention-device-distribution.png
diff --git a/images/retention-geographic-distribution.png → ...ets/retention-geographic-distribution.png b/images/retention-geographic-distribution.png → ...ets/retention-geographic-distribution.png
diff --git a/images/retention-returning-users.png → docs/assets/retention-returning-users.png b/images/retention-returning-users.png → docs/assets/retention-returning-users.png
diff --git a/images/revenuecat_webhook_config.png → docs/assets/revenuecat_webhook_config.png b/images/revenuecat_webhook_config.png → docs/assets/revenuecat_webhook_config.png
diff --git a/images/system-versions-example.png → docs/assets/system-versions-example.png b/images/system-versions-example.png → docs/assets/system-versions-example.png
diff --git a/images/table-chart.PNG → docs/assets/table-chart.PNG b/images/table-chart.PNG → docs/assets/table-chart.PNG
diff --git a/images/test_mode.png → docs/assets/test_mode.png b/images/test_mode.png → docs/assets/test_mode.png
diff --git a/images/typedigital.png → docs/assets/typedigital.png b/images/typedigital.png → docs/assets/typedigital.png
diff --git a/images/update_next_major_version.png → docs/assets/update_next_major_version.png b/images/update_next_major_version.png → docs/assets/update_next_major_version.png
diff --git a/images/update_package.png → docs/assets/update_package.png b/images/update_package.png → docs/assets/update_package.png
diff --git a/images/xcode-swift-package.png → docs/assets/xcode-swift-package.png b/images/xcode-swift-package.png → docs/assets/xcode-swift-package.png
diff --git a/images/xcode-swift-package1.png → docs/assets/xcode-swift-package1.png b/images/xcode-swift-package1.png → docs/assets/xcode-swift-package1.png
diff --git a/images/xcode-swift-package2.png → docs/assets/xcode-swift-package2.png b/images/xcode-swift-package2.png → docs/assets/xcode-swift-package2.png
diff --git a/images/yt-4-minute-setup.png → docs/assets/yt-4-minute-setup.png b/images/yt-4-minute-setup.png → docs/assets/yt-4-minute-setup.png
diff --git a/images/yt-app-analytics.png → docs/assets/yt-app-analytics.png b/images/yt-app-analytics.png → docs/assets/yt-app-analytics.png
diff --git a/images/yt-app-store-connect.png → docs/assets/yt-app-store-connect.png b/images/yt-app-store-connect.png → docs/assets/yt-app-store-connect.png
diff --git a/images/yt-built-in-charts.png → docs/assets/yt-built-in-charts.png b/images/yt-built-in-charts.png → docs/assets/yt-built-in-charts.png
diff --git a/images/yt-custom-charts.png → docs/assets/yt-custom-charts.png b/images/yt-custom-charts.png → docs/assets/yt-custom-charts.png
diff --git a/basics/acquisition.md → docs/basics/acquisition.md b/basics/acquisition.md → docs/basics/acquisition.md
diff --git a/basics/activation.md → docs/basics/activation.md b/basics/activation.md → docs/basics/activation.md
diff --git a/basics/basics.json → docs/basics/basics.json b/basics/basics.json → docs/basics/basics.json
diff --git a/basics/index.md → docs/basics/index.md b/basics/index.md → docs/basics/index.md
diff --git a/basics/metrics.md → docs/basics/metrics.md b/basics/metrics.md → docs/basics/metrics.md
diff --git a/basics/pirate-metrics.md → docs/basics/pirate-metrics.md b/basics/pirate-metrics.md → docs/basics/pirate-metrics.md
diff --git a/basics/retention.md → docs/basics/retention.md b/basics/retention.md → docs/basics/retention.md
diff --git a/glossary.md → docs/glossary.md b/glossary.md → docs/glossary.md
diff --git a/guides/android-setup.md → docs/guides/android-setup.md b/guides/android-setup.md → docs/guides/android-setup.md
diff --git a/guides/flutter-setup.md → docs/guides/flutter-setup.md b/guides/flutter-setup.md → docs/guides/flutter-setup.md
diff --git a/guides/guides.json → docs/guides/guides.json b/guides/guides.json → docs/guides/guides.json
diff --git a/guides/javascript-setup.md → docs/guides/javascript-setup.md b/guides/javascript-setup.md → docs/guides/javascript-setup.md
@@ -14,17 +14,15 @@ order: 300
 
 The TelemetryDeck SDK has no dependencies and supports **modern evergreen browsers** and **modern versions of Node.js** with support for [cryptography](https://caniuse.com/cryptography).
 
-{% noteinfo "There are multiple ways of adding TelemetryDeck to a web site" %}
+!!! warning "There are multiple ways of adding TelemetryDeck to a web site"
 
-There are different tutorials you should read depending on your use case.
+    There are different tutorials you should read depending on your use case.
 
-- The [TelemetryDeck Web SDK](/docs/guides/web-setup) is a quick and easy way to include web analytics into your website. This is fantastic for blogs, landing pages, static websites, and content-driven websites.
-
-- If you are building a JavaScript application – a Progressive Web App written in React, Vue, Angular, Svelte, Ember, or mobile or desktop apps written with React Native, Electron, Ionic, and so on, you should read this guide.
-
-[Our blog post](/blog/js-sdk-2-0/) explains the differences between the two SDKs in more detail.
-
-{% endnoteinfo %}
+    - The [TelemetryDeck Web SDK](/docs/guides/web-setup) is a quick and easy way to include web analytics into your website. This is fantastic for blogs, landing pages, static websites, and content-driven websites.
+
+    - If you are building a JavaScript application – a Progressive Web App written in React, Vue, Angular, Svelte, Ember, or mobile or desktop apps written with React Native, Electron, Ionic, and so on, you should read this guide.
+
+    [Our blog post](/blog/js-sdk-2-0/) explains the differences between the two SDKs in more detail.
 
 ## Set up
 
@@ -87,14 +85,11 @@ If can't specify a user identifier at initialization, you can set it later by se
 
 Please note that `td.signal` is an async function that returns a promise.
 
-{% notewarning "Special treatment for frameworks" %}
-
-Some frameworks, like Svelte, don't need `crypto` and node.js. Here are some tips on how to implement TelemetryDeck when using some of these special frameworks:
-
-- The initialization should happen once, and the TD object should be passed around in a service or singleton.
-- The `td.send` function should be used to send signals, either automatically in a router-like object or on a per-feature basis.
+!!! warning "Special treatment for frameworks"
 
-{% endnotewarning %}
+    Some frameworks, like Svelte, don't need `crypto` and node.js. Here are some tips on how to implement TelemetryDeck when using some of these special frameworks:
+    - The initialization should happen once, and the TD object should be passed around in a service or singleton.
+    - The `td.send` function should be used to send signals, either automatically in a router-like object or on a per-feature basis.
 
 ### Advanced initialization options
 

diff --git a/guides/objective-c-setup.md → docs/guides/objective-c-setup.md b/guides/objective-c-setup.md → docs/guides/objective-c-setup.md
diff --git a/guides/privacy-faq.md → docs/guides/privacy-faq.md b/guides/privacy-faq.md → docs/guides/privacy-faq.md
diff --git a/guides/react-setup.md → docs/guides/react-setup.md b/guides/react-setup.md → docs/guides/react-setup.md
diff --git a/guides/swift-setup.md → docs/guides/swift-setup.md b/guides/swift-setup.md → docs/guides/swift-setup.md
diff --git a/guides/vue-setup.md → docs/guides/vue-setup.md b/guides/vue-setup.md → docs/guides/vue-setup.md
diff --git a/guides/web-setup.md → docs/guides/web-setup.md b/guides/web-setup.md → docs/guides/web-setup.md
@@ -109,14 +109,12 @@ This means that the Web SDK will recognize recurring users on the same day on th
 
 ## If you're a developer
 
-{% noteinfo "There are multiple ways of adding TelemetryDeck to a web site" %}
+!!! warning "There are multiple ways of adding TelemetryDeck to a web site"
 
-There are different tutorials you should read depending on your use case.
+    There are different tutorials you should read depending on your use case.
 
-- If you are building a **JavaScript application or PWA using node package manager**, you should read the [Node Package Setup Guide](/docs/guides/javascript-setup).
-- If you are building a **website or blog**, and want to include TelemetryDeck with a simple script tag similar to Google Analytics or Plausible Analytics, you should read this guide.
-
-{% endnoteinfo %}
+    - If you are building a **JavaScript application or PWA using node package manager**, you should read the [Node Package Setup Guide](/docs/guides/javascript-setup).
+    - If you are building a **website or blog**, and want to include TelemetryDeck with a simple script tag similar to Google Analytics or Plausible Analytics, you should read this guide.
 
 ## What to do next