Merge pull request #68 from directus/kl-c-14

Small changes
directus · Dec 4, 2024 · 334fb0e · 334fb0e
2 parents 7ad4705 + a67a286
commit 334fb0e
Show file tree

Hide file tree

Showing 22 changed files with 76 additions and 39 deletions.
diff --git a/app/components/header/HeaderHat.vue b/app/components/header/HeaderHat.vue
@@ -19,6 +19,12 @@ const isOpen = ref(false);
 			</NuxtLink>
 			<SearchButton style="flex-grow: 1;" />
 			<div class="links">
+				<a
+					href="https://bsky.app/profile/directus.io"
+					target="_blank"
+				>
+					<Icon name="ri:bluesky-fill" />
+				</a>
 				<a
 					href="https://x.com/directus"
 					target="_blank"

diff --git a/app/components/header/HeaderNav.vue b/app/components/header/HeaderNav.vue
@@ -26,12 +26,12 @@ const nav = ref<AreaNavigation[]>([
 		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',
@@ -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',
 	},
 ];
 

diff --git 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.
+	::
 ::
 
 <div style="margin-bottom: 4rem;"></div>
@@ -41,7 +40,11 @@ additional_paths:
 
 :article-cards{:show-description=false :paths='["/connect/quickstart", { "title": "API Reference", "_path": "/api"}, "/connect/sdk"]'}
 
-<!-- Tutorials -->
+<!-- ## Tutorials
+
+:article-cards{:show-description=false :paths='[{ "title": "Directus with Next.js", "_path": "/tutorials?tags=nextjs"}, { "title": Project Builds", "_path": "/tutorials/projects"}, { "title": "Using Directus Auth", "_path": "/tutorials?tags=directus-auth"}]'}
+
+[More Tutorials](https://directus.io/tutorials) -->
 
 ## Releases
 

diff --git 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.
 
-<!-- TODO ::callout{type="tutorials" url="/tutorials"}
+::callout{type="tutorials" url="/tutorials"}
 See all project and use-case tutorials.
-:: -->
+::
 
 ## Directus Cloud
 

diff --git 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.
 ::
 
-<!-- TODO ## Deploy Directus
+## Deploy Directus
 
-We also have a number of guides on deploying Directus to various cloud providers, like Amazon Web Services, Microsoft Azure, and Google Cloud Platform.
+We also have a number of guides on self-hosting Directus on various cloud providers, like Amazon Web Services, Microsoft Azure, and Google Cloud Platform.
 
-::callout{type="tutorials" url="/tutorials/tags/deployment"}
+::callout{type="tutorials" url="/tutorials/self-hosting"}
 
 See how to deploy Directus on multiple hosting providers.
 
-:: -->
+::
 
 ## Next Steps
 

diff --git 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.
 ::
 
-<!-- TODO: ::callout{type="tutorials" url="/tutorials" title="Tutorials"}
+::callout{type="tutorials" url="/tutorials" title="Tutorials"}
 Framework, project, and other implementation guides.
-:: -->
+::
 
 ::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/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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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
@@ -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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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
@@ -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"}
+<div style="margin-bottom: 1rem;"></div>
+
 This guide will cover creating a collection in Directus via the Data Studio, creating fields, and configuring relationships.
 
 :directus-cloud

diff --git 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.
 
-<!-- TODO ::callout{type="tutorials" url="/tutorials/tags/live-preview"}
+::callout{type="tutorials" url="/tutorials/getting-started"}
 Read tutorials on implementing live preview.
-:: -->
+::
 
 ### Accountability
 

diff --git 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. |
 
-<!-- TODO ::callout{type="tutorials" url="/tutorials/reusable-page-components"}
+::callout{type="tutorials" url="/tutorials/getting-started/create-reusable-blocks-with-many-to-any-relationships"}
 Read our tutorial on using a Builder (M2A) to create reusable page components.
-:: -->
+::
 
 ### Many To Many
 

diff --git 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.
 
-<!-- TODO ::callout{type="tutorials" url="/tutorials/reusable-page-components"}
+::callout{type="tutorials" url="/tutorials/getting-started/create-reusable-blocks-with-many-to-any-relationships"}
 Read our tutorial on using a Builder (M2A) to create reusable page components.
-:: -->
+::
 
 ## Translations
 

diff --git 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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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
@@ -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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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/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
 }
 ```
 
-<!-- TODO: Fix broken link -->
-
 ::callout{type="dev-docs" url="/configuration/email"}
 An email service must be configured to send password reset requests.
 ::

diff --git 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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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/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<Schema>('http://directus.example.com').with(rest());
 	```
 
-	<!-- TODO ::callout{type="tutorials" url="/tutorials/sdk-types"}
+	::callout{type="tutorials" url="/tutorials/tips-and-tricks/advanced-types-with-the-directus-sdk"}
 	Learn how to create a Schema for SDK client creation.
-	:: -->
+	::
 	::
 ::
 

diff --git 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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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
@@ -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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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
@@ -5,12 +5,13 @@ 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"}
+<div style="margin-bottom: 1rem;"></div>
+
 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.
 
-<!-- TODO: Link to GraphQL & raw WS tutorials -->
-
 ## Before You Start
 
 You will need a Directus project.

diff --git 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"}
+<div style="margin-bottom: 1rem;"></div>
 
+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
 

diff --git 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.
 
-<!-- TODO ::callout{type="tutorials" url="/tutorials/tags/extensions"}
+:callout{type="tutorials" url="/tutorials/extensions"}
 Learn more about building extensions through our tutorials.
-:: -->
+::
 
 </div>
-Original file line number
+Diff line change
@@ Expand Up @@
     }
     ```
-    <!-- TODO: Fix broken link -->
     ::callout{type="dev-docs" url="/configuration/email"}
     An email service must be configured to send password reset requests.
     ::
@@ Expand Down @@