From 704fd221f992853407899e58a97f9ce2dbfe4857 Mon Sep 17 00:00:00 2001 From: Kevin Lewis Date: Wed, 4 Dec 2024 15:28:33 +0100 Subject: [PATCH 1/6] Add tutorials --- app/components/header/HeaderNav.vue | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/app/components/header/HeaderNav.vue b/app/components/header/HeaderNav.vue index db2389a8..3de3f230 100644 --- a/app/components/header/HeaderNav.vue +++ b/app/components/header/HeaderNav.vue @@ -26,12 +26,12 @@ const nav = ref([ dir: '/cloud', color: 'var(--area--cloud)', }, - // { - // label: 'Tutorials', - // to: '/tutorials', - // dir: '/tutorials', - // color: 'var(--area--tutorials)', - // }, + { + label: 'Tutorials', + to: '/tutorials', + dir: '/tutorials', + color: 'var(--area--tutorials)', + }, { label: 'Community', to: '/community', From 1841b5d485606dd1e26b49d56c2811dfccb182ed Mon Sep 17 00:00:00 2001 From: Kevin Lewis Date: Wed, 4 Dec 2024 15:28:48 +0100 Subject: [PATCH 2/6] Starter Kits -> Templates --- app/components/header/HeaderNav.vue | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/app/components/header/HeaderNav.vue b/app/components/header/HeaderNav.vue index 3de3f230..9723660d 100644 --- a/app/components/header/HeaderNav.vue +++ b/app/components/header/HeaderNav.vue @@ -46,8 +46,8 @@ const rightNav = [ href: 'https://directus.io/tv', }, { - label: 'Starter Kits', - href: 'https://directus.io/plus', + label: 'Templates', + href: 'https://directus.io/templates', }, ]; From be3f9831c2456c00aab3c92033c9cc308bca4cdc Mon Sep 17 00:00:00 2001 From: Kevin Lewis Date: Wed, 4 Dec 2024 15:30:13 +0100 Subject: [PATCH 3/6] Added Bluesky --- app/components/header/HeaderHat.vue | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/app/components/header/HeaderHat.vue b/app/components/header/HeaderHat.vue index 73f76eeb..0d00802a 100644 --- a/app/components/header/HeaderHat.vue +++ b/app/components/header/HeaderHat.vue @@ -19,6 +19,12 @@ const isOpen = ref(false);
+ + + Date: Wed, 4 Dec 2024 16:28:01 +0100 Subject: [PATCH 4/6] Swap order of demos on homepage --- content/1.getting-started/0.home.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/content/1.getting-started/0.home.md b/content/1.getting-started/0.home.md index 2a6dd701..e5f4fe6a 100644 --- a/content/1.getting-started/0.home.md +++ b/content/1.getting-started/0.home.md @@ -10,10 +10,6 @@ additional_paths: ## Try a Demo ::tabs - ::tab{label="Hosted Demo"} - Try our [hosted demo project](https://directus.pizza/?utm_source=directus-docs&utm_campaign=docs-home). This is a public demo project that is occassionally reset but please don't input sensitive data. - :: - ::tab{label="Local Demo"} Run Docker locally and use the following command to start the project. @@ -23,6 +19,9 @@ additional_paths: This project has no persistence. All data will be lost when the container is stopped. Read our [Create a Project guide](/getting-started/create-a-project) to learn how to create a project with persistence. :: + ::tab{label="Hosted Demo"} + Try our [hosted demo project](https://directus.pizza/?utm_source=directus-docs&utm_campaign=docs-home). This is a public demo project that is occassionally reset but please don't input sensitive data. + :: ::
From 45c88c0f60b80d1d96a612f922d432edbfac48c5 Mon Sep 17 00:00:00 2001 From: Kevin Lewis Date: Wed, 4 Dec 2024 16:52:11 +0100 Subject: [PATCH 5/6] Link to tutorials section --- content/1.getting-started/0.home.md | 6 +++++- content/1.getting-started/0.platform-overview.md | 4 ++-- content/1.getting-started/1.create-a-project.md | 10 +++++----- content/1.getting-started/2.resources.md | 8 ++++++-- content/2.data-modeling/2.collections.md | 4 ++-- content/2.data-modeling/4.interfaces.md | 4 ++-- content/2.data-modeling/5.relationships.md | 4 ++-- content/4.auth/5.email-login.md | 2 -- content/5.connect/6.sdk.md | 4 ++-- content/8.realtime/1.quickstart.md | 2 -- content/_partials/extensions-app-internals.md | 4 ++-- 11 files changed, 28 insertions(+), 24 deletions(-) diff --git a/content/1.getting-started/0.home.md b/content/1.getting-started/0.home.md index e5f4fe6a..284913bc 100644 --- a/content/1.getting-started/0.home.md +++ b/content/1.getting-started/0.home.md @@ -40,7 +40,11 @@ additional_paths: :article-cards{:show-description=false :paths='["/connect/quickstart", { "title": "API Reference", "_path": "/api"}, "/connect/sdk"]'} - + ## Releases diff --git a/content/1.getting-started/0.platform-overview.md b/content/1.getting-started/0.platform-overview.md index 03655a64..f0b64fef 100644 --- a/content/1.getting-started/0.platform-overview.md +++ b/content/1.getting-started/0.platform-overview.md @@ -30,9 +30,9 @@ Using Directus Insights, your whole team can build custom applications. Ditch th Establish a single source of truth for all data. Build no-code analytics dashboards to gain insights into company KPIs and other metrics. Coalesce previously siloed data and use Directus Automate to keep everything in sync. - +:: ## Directus Cloud diff --git a/content/1.getting-started/1.create-a-project.md b/content/1.getting-started/1.create-a-project.md index e6bfb339..9221d409 100644 --- a/content/1.getting-started/1.create-a-project.md +++ b/content/1.getting-started/1.create-a-project.md @@ -57,7 +57,7 @@ Create a `docker-compose.yml` file in the `directus` directory: ```yaml [docker-compose.yml] services: directus: - image: directus/directus:11.1.1 + image: directus/directus:11.3.2 ports: - 8055:8055 volumes: @@ -101,15 +101,15 @@ The project that runs from this `docker-compose.yml` file is not production-read Read our self-hosting product checklist. :: - +:: ## Next Steps diff --git a/content/1.getting-started/2.resources.md b/content/1.getting-started/2.resources.md index 61f0b1e0..5cb0ef50 100644 --- a/content/1.getting-started/2.resources.md +++ b/content/1.getting-started/2.resources.md @@ -14,9 +14,9 @@ Detailed documentation about the Directus platform. Comprehensive list of endpoints available in your projects. :: - +:: ::callout{type="community" url="/community" title="Community"} Get involved through feature requests, code contribution, education, and more. @@ -84,3 +84,7 @@ Our main community chat with thousands of Directus developers. ::callout{type="link" title="X" url="https://x.com/directus"} The latest product info and sneak-peeks. :: + +::callout{type="link" title="Bluesky" url="https://bsky.app/profile/directus.io"} +Be part of the conversation with our team. +:: diff --git a/content/2.data-modeling/2.collections.md b/content/2.data-modeling/2.collections.md index 71de7c8f..36ceb7cb 100644 --- a/content/2.data-modeling/2.collections.md +++ b/content/2.data-modeling/2.collections.md @@ -78,9 +78,9 @@ Live preview is used by :product-link{product="editor"} and allows for your appl You can use item field values to construct the URL used by the live preview, including unique identifiers and content version, allowing for previewing content versions before promoting them to the main version. - +:: ### Accountability diff --git a/content/2.data-modeling/4.interfaces.md b/content/2.data-modeling/4.interfaces.md index 866ede74..8eca5509 100644 --- a/content/2.data-modeling/4.interfaces.md +++ b/content/2.data-modeling/4.interfaces.md @@ -411,9 +411,9 @@ When this field is added to a collection, Directus will create a Many to Many (M | Related Collections | Which collections should items be selected from. | | Allow Duplicates | Allow users to add the same Item multiple times. | - +:: ### Many To Many diff --git a/content/2.data-modeling/5.relationships.md b/content/2.data-modeling/5.relationships.md index cc9592f8..5947da87 100644 --- a/content/2.data-modeling/5.relationships.md +++ b/content/2.data-modeling/5.relationships.md @@ -61,9 +61,9 @@ In a M2A relationship, one collection can be related to any item in any collecti When you configure a M2A in Directus, a M2A `Alias` field is created as well as a junction collection. The junction collection in a M2A relationship also stores the collection name for related collections. - +:: ## Translations diff --git a/content/4.auth/5.email-login.md b/content/4.auth/5.email-login.md index f9d8baf9..31baf436 100644 --- a/content/4.auth/5.email-login.md +++ b/content/4.auth/5.email-login.md @@ -245,8 +245,6 @@ Requesting a password reset will send an email to the user with a URL to the Dat } ``` - - ::callout{type="dev-docs" url="/configuration/email"} An email service must be configured to send password reset requests. :: diff --git a/content/5.connect/6.sdk.md b/content/5.connect/6.sdk.md index 3e6996c1..75ecc578 100644 --- a/content/5.connect/6.sdk.md +++ b/content/5.connect/6.sdk.md @@ -49,9 +49,9 @@ The Directus SDK is a "Composable Client" that allows you to customize and build const directus = createDirectus('http://directus.example.com').with(rest()); ``` - + :: :: :: diff --git a/content/8.realtime/1.quickstart.md b/content/8.realtime/1.quickstart.md index aa01efe9..0d9d4e84 100644 --- a/content/8.realtime/1.quickstart.md +++ b/content/8.realtime/1.quickstart.md @@ -9,8 +9,6 @@ Instead of needing to make a request to see if data has changed, your applicatio This guide will cover getting started with :product-link{product="realtime"} by connecting to Directus with the Directus SDK on the web, subscribing to changes, and creating new items. - - ## Before You Start You will need a Directus project. diff --git a/content/_partials/extensions-app-internals.md b/content/_partials/extensions-app-internals.md index b46732af..af43de9c 100644 --- a/content/_partials/extensions-app-internals.md +++ b/content/_partials/extensions-app-internals.md @@ -18,8 +18,8 @@ Learn more about using the Directus UI library. To avoid Cross Site Request Forgery (CSRF), app extensions cannot make requests to external servers by default. A common approach to achieve this is to create a bundle containing an endpoint that makes the external request, and an app extension that uses the now-internal endpoint to retrieve data. - +::
From a67a286b332d0ccb1af322ad6ad945931245a90b Mon Sep 17 00:00:00 2001 From: Kevin Lewis Date: Wed, 4 Dec 2024 17:26:07 +0100 Subject: [PATCH 6/6] Added Directus TV embeds to quickstarts --- content/10.extensions/0.overview.md | 3 +++ content/11.configuration/14.theming.md | 3 +++ content/2.data-modeling/1.quickstart.md | 3 +++ content/4.auth/1.quickstart.md | 3 +++ content/4.auth/3.access-control.md | 4 ++++ content/5.connect/1.quickstart.md | 3 +++ content/6.files/1.quickstart.md | 3 +++ content/7.automate/1.quickstart.md | 3 +++ content/8.realtime/1.quickstart.md | 3 +++ content/9.insights/1.overview.md | 6 +++--- 10 files changed, 31 insertions(+), 3 deletions(-) diff --git a/content/10.extensions/0.overview.md b/content/10.extensions/0.overview.md index 05eb117e..b882a2e1 100644 --- a/content/10.extensions/0.overview.md +++ b/content/10.extensions/0.overview.md @@ -5,6 +5,9 @@ description: Extensions are used to extend the functionality of Directus. # Extensions Overview +:video-embed{type="directus-tv" id="c7ab64da-f34d-42c9-8a1a-03e6026cc7e5"} +
+ Directus has been built to be extensible - both allowing for powerful enhancements to be built for single projects, and for publishing in the [Directus Marketplace](/extensions/marketplace). Extensions in Directus run within the same environment as the main application, allowing them to leverage existing access to underlying [services](/extensions/api-extensions/services) and [UI components](/extensions/app-extensions/ui-library). diff --git a/content/11.configuration/14.theming.md b/content/11.configuration/14.theming.md index 10c6a422..5320e7f9 100644 --- a/content/11.configuration/14.theming.md +++ b/content/11.configuration/14.theming.md @@ -4,6 +4,9 @@ description: Configuration of the Data Studio's theming engine and appearance se # Theming +:video-embed{type="directus-tv" id="8ad4795b-963c-4ebd-8921-38ea2dda9f44"} +
+ The Directus Data Studio has been developed with customization and extensibility in mind. Colors and styles referenced within the codebase are based around theme rules which enables making comprehensive styling changes to the Data Studio. Theming options can be found in dedicated section in the Settings Module. diff --git a/content/2.data-modeling/1.quickstart.md b/content/2.data-modeling/1.quickstart.md index ca5e8603..bd422007 100644 --- a/content/2.data-modeling/1.quickstart.md +++ b/content/2.data-modeling/1.quickstart.md @@ -5,6 +5,9 @@ description: This guide will cover creating a collection in Directus via the Dat # Data Modeling Quickstart +:video-embed{type="directus-tv" id="637aafa2-b323-4ad0-adf0-ba52328bb798"} +
+ This guide will cover creating a collection in Directus via the Data Studio, creating fields, and configuring relationships. :directus-cloud diff --git a/content/4.auth/1.quickstart.md b/content/4.auth/1.quickstart.md index bd6fa27e..28fe786e 100644 --- a/content/4.auth/1.quickstart.md +++ b/content/4.auth/1.quickstart.md @@ -5,6 +5,9 @@ description: Get started with Directus Auth. Learn how to register, login, creat # Auth Quickstart +:video-embed{type="directus-tv" id="04ffd615-6d1d-45de-9c1b-2ff9206fe343"} +
+ This guide will cover registering users, logging in, and making an authenticated request. :partial{content="quickstart-making-calls"} diff --git a/content/4.auth/3.access-control.md b/content/4.auth/3.access-control.md index 3bdce481..166ae371 100644 --- a/content/4.auth/3.access-control.md +++ b/content/4.auth/3.access-control.md @@ -4,10 +4,14 @@ description: Manage user and role permissions and policies for interacting with # Access Control +:video-embed{type="directus-tv" id="04ffd615-6d1d-45de-9c1b-2ff9206fe343"} +
+ Access control is a critical part of managing data - what different users in their various roles should be able to create, read, update, delete, and share. You can find Access Control in the Settings module. + ![A diagram showing the relationship between permissions, policies, roles, and users.](https://product-team.directus.app/assets/9c4b55ec-5402-4460-a091-f22406f524e1.jpg) ## Users diff --git a/content/5.connect/1.quickstart.md b/content/5.connect/1.quickstart.md index 86a9e789..008564e8 100644 --- a/content/5.connect/1.quickstart.md +++ b/content/5.connect/1.quickstart.md @@ -5,6 +5,9 @@ description: Get started with Directus APIs. Learn to interact with collections, # Connect Quickstart +:video-embed{type="directus-tv" id="4cc18530-ba2a-44f3-bb2e-2bfe4ad024d5"} +
+ This guide will cover interacting with collections in Directus via the REST APIs automatically created on your behalf. You will fetch and create data, and make your first request with the Directus SDK. :partial{content="quickstart-making-calls"} diff --git a/content/6.files/1.quickstart.md b/content/6.files/1.quickstart.md index bdb335bb..504118be 100644 --- a/content/6.files/1.quickstart.md +++ b/content/6.files/1.quickstart.md @@ -5,6 +5,9 @@ description: This guide will cover importing a file via URL, requesting assets, # Files Quickstart +:video-embed{type="directus-tv" id="43612e4c-1bd9-411e-bd73-9c835a9b51e0"} +
+ This guide will cover importing a file via URL, requesting assets, and using transformation parameters. :directus-cloud diff --git a/content/7.automate/1.quickstart.md b/content/7.automate/1.quickstart.md index 1b88ada5..aa0a40b8 100644 --- a/content/7.automate/1.quickstart.md +++ b/content/7.automate/1.quickstart.md @@ -5,6 +5,9 @@ description: Get started using flows, triggers, operations and the data chain in # Automate Quickstart +:video-embed{type="directus-tv" id="6e6965e7-13cc-4f86-b512-f567d66cfbe9"} +
+ This guide will cover custom event-driven data processing using Directus Automate. ## Before You Start diff --git a/content/8.realtime/1.quickstart.md b/content/8.realtime/1.quickstart.md index 0d9d4e84..a071ef2f 100644 --- a/content/8.realtime/1.quickstart.md +++ b/content/8.realtime/1.quickstart.md @@ -5,6 +5,9 @@ description: This guide will cover connecting to Directus via WebSockets on the # Realtime Quickstart +:video-embed{type="directus-tv" id="4d3c062f-0f30-41b7-83e9-3d2ed34a86f4"} +
+ Instead of needing to make a request to see if data has changed, your application can receive updates in realtime over a persistent connection with Directus. All subscriptions and actions over a realtime connection use the permissions of the authenticated user, or public permissions if not authenticated. This guide will cover getting started with :product-link{product="realtime"} by connecting to Directus with the Directus SDK on the web, subscribing to changes, and creating new items. diff --git a/content/9.insights/1.overview.md b/content/9.insights/1.overview.md index 1d8e9099..5c4b8cd5 100644 --- a/content/9.insights/1.overview.md +++ b/content/9.insights/1.overview.md @@ -5,10 +5,10 @@ description: Insights is a module in Directus that allows rapid, no-code build-o # Insights Overview -Insights is a module in Directus that allows rapid, no-code build-out of analytics dashboards. It can be used for a variety of use-cases, such as business intelligence, user progress tracking, web traffic conversions, and more. - -![The insights module showing a list of dashboards](https://product-team.directus.app/assets/784aa949-5b27-4372-9f39-c85dd382f27e.webp) +:video-embed{type="directus-tv" id="20666ca0-00e3-4d71-985b-f7c4abbe3bd1"} +
+Insights is a module in Directus that allows rapid, no-code build-out of analytics dashboards. It can be used for a variety of use-cases, such as business intelligence, user progress tracking, web traffic conversions, and more. ## Dashboards