From 5e8b3669ac7875b5e0db6b13c3b9fdd824bf22c0 Mon Sep 17 00:00:00 2001
From: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Date: Tue, 25 Mar 2025 19:57:05 +0100
Subject: [PATCH 1/3] Add alias for tutorials
---
docs/dev/tools/tutorials.md | 30 +++---------------------------
docs/tutorials/_index.md | 25 +++++++++++++++++++++++--
docs/tutorials/projects/_index.md | 2 +-
docs/tutorials/services/_index.md | 2 +-
layouts/partials/sidebar-tree.html | 2 +-
5 files changed, 29 insertions(+), 32 deletions(-)
diff --git a/docs/dev/tools/tutorials.md b/docs/dev/tools/tutorials.md
index 40b9ae36ad..2ff7afe754 100644
--- a/docs/dev/tools/tutorials.md
+++ b/docs/dev/tools/tutorials.md
@@ -2,32 +2,8 @@
title: "Tutorials"
linkTitle: "Tutorials"
weight: 30
-type: docs
-layout: "tutorials"
-videos:
- [
- "/tutorials/videos/scuttle-gamepad-preview.webm",
- "/tutorials/videos/scuttle-gamepad-preview.mp4",
- ]
-videoAlt: "Drive a Scuttle robot with a Bluetooth gamepad."
-images:
- [
- "/tutorials/videos/scuttle-gamepad-preview.gif",
- "/tutorials/try-viam-sdk/image1.gif",
- ]
-description: "Build a machine yourself by following along with a tutorial."
-no_list: true
-hide_children: true
-sitemap:
- priority: 1.0
-aliases:
- - /build/
- - /tutorials/
- - /how-tos/
- - /use-cases/
-outputs:
- - rss
- - html
-date: "2024-10-20"
+type: "docs"
+layout: "empty"
+canonical: "/tutorials/"
# updated: "" # When the content was last entirely checked
---
diff --git a/docs/tutorials/_index.md b/docs/tutorials/_index.md
index e17879e2ea..c9ad59c971 100644
--- a/docs/tutorials/_index.md
+++ b/docs/tutorials/_index.md
@@ -3,14 +3,35 @@ title: "Tutorials"
linkTitle: "Tutorials"
weight: 300
type: docs
-layout: "empty"
+layout: "tutorials"
+videos:
+ [
+ "/tutorials/videos/scuttle-gamepad-preview.webm",
+ "/tutorials/videos/scuttle-gamepad-preview.mp4",
+ ]
+videoAlt: "Drive a Scuttle robot with a Bluetooth gamepad."
+images:
+ [
+ "/tutorials/videos/scuttle-gamepad-preview.gif",
+ "/tutorials/try-viam-sdk/image1.gif",
+ ]
+description: "Build a machine yourself by following along with a tutorial."
sitemap:
priority: 1.0
-toc_hide: false
+toc_hide: true
# do not remove hide children - it causes a layout issue
+no_list: true
hide_children: true
+sitemap:
+ priority: 1.0
+aliases:
+ - /build/
+ - /tutorials/
+ - /how-tos/
+ - /use-cases/
outputs:
- rss
- html
- typesense
+date: "2024-10-20"
---
diff --git a/docs/tutorials/projects/_index.md b/docs/tutorials/projects/_index.md
index ee945f2f8d..0492284f65 100644
--- a/docs/tutorials/projects/_index.md
+++ b/docs/tutorials/projects/_index.md
@@ -6,5 +6,5 @@ weight: 60
type: docs
empty_node: true
layout: "empty"
-canonical: "tutorials/"
+canonical: "/tutorials/"
---
diff --git a/docs/tutorials/services/_index.md b/docs/tutorials/services/_index.md
index a8a2c9b863..33b9557933 100644
--- a/docs/tutorials/services/_index.md
+++ b/docs/tutorials/services/_index.md
@@ -6,5 +6,5 @@ weight: 40
type: docs
empty_node: true
layout: "empty"
-canonical: "tutorials/"
+canonical: "/tutorials/"
---
diff --git a/layouts/partials/sidebar-tree.html b/layouts/partials/sidebar-tree.html
index 569249a0cc..6c01ad8b24 100644
--- a/layouts/partials/sidebar-tree.html
+++ b/layouts/partials/sidebar-tree.html
@@ -55,7 +55,7 @@
{{ if eq $p.Section "tutorials"}}
<!-- If this is a tutorial -->
-<a href="/dev/tools/tutorials/" target="{{ . }}" rel="noopener" class="">
+<a href="/tutorials/" target="{{ . }}" rel="noopener" class="">
<span> Tutorials </span>
</a>
<li class="active-path tutorial-heading">
From 342179171a1db0d012df06166a33c5bc534caecd Mon Sep 17 00:00:00 2001
From: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Date: Tue, 8 Apr 2025 14:09:14 +0200
Subject: [PATCH 2/3] Update
---
docs/dev/tools/tutorials.md | 30 +++++++++++++++++++++++++++---
docs/tutorials/_index.md | 22 ++--------------------
2 files changed, 29 insertions(+), 23 deletions(-)
diff --git a/docs/dev/tools/tutorials.md b/docs/dev/tools/tutorials.md
index 2ff7afe754..40b9ae36ad 100644
--- a/docs/dev/tools/tutorials.md
+++ b/docs/dev/tools/tutorials.md
@@ -2,8 +2,32 @@
title: "Tutorials"
linkTitle: "Tutorials"
weight: 30
-type: "docs"
-layout: "empty"
-canonical: "/tutorials/"
+type: docs
+layout: "tutorials"
+videos:
+ [
+ "/tutorials/videos/scuttle-gamepad-preview.webm",
+ "/tutorials/videos/scuttle-gamepad-preview.mp4",
+ ]
+videoAlt: "Drive a Scuttle robot with a Bluetooth gamepad."
+images:
+ [
+ "/tutorials/videos/scuttle-gamepad-preview.gif",
+ "/tutorials/try-viam-sdk/image1.gif",
+ ]
+description: "Build a machine yourself by following along with a tutorial."
+no_list: true
+hide_children: true
+sitemap:
+ priority: 1.0
+aliases:
+ - /build/
+ - /tutorials/
+ - /how-tos/
+ - /use-cases/
+outputs:
+ - rss
+ - html
+date: "2024-10-20"
# updated: "" # When the content was last entirely checked
---
diff --git a/docs/tutorials/_index.md b/docs/tutorials/_index.md
index c9ad59c971..3f4253f36e 100644
--- a/docs/tutorials/_index.md
+++ b/docs/tutorials/_index.md
@@ -3,32 +3,14 @@ title: "Tutorials"
linkTitle: "Tutorials"
weight: 300
type: docs
-layout: "tutorials"
-videos:
- [
- "/tutorials/videos/scuttle-gamepad-preview.webm",
- "/tutorials/videos/scuttle-gamepad-preview.mp4",
- ]
-videoAlt: "Drive a Scuttle robot with a Bluetooth gamepad."
-images:
- [
- "/tutorials/videos/scuttle-gamepad-preview.gif",
- "/tutorials/try-viam-sdk/image1.gif",
- ]
-description: "Build a machine yourself by following along with a tutorial."
-sitemap:
- priority: 1.0
+layout: "empty"
+canonical: "/dev/tools/tutorials/"
toc_hide: true
# do not remove hide children - it causes a layout issue
no_list: true
hide_children: true
sitemap:
priority: 1.0
-aliases:
- - /build/
- - /tutorials/
- - /how-tos/
- - /use-cases/
outputs:
- rss
- html
From 3f1aaa555a8488f3194038917a99e02ed8bc4e6c Mon Sep 17 00:00:00 2001
From: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Date: Tue, 8 Apr 2025 14:11:15 +0200
Subject: [PATCH 3/3] Update
---
docs/operate/reference/prepare/beaglebone-setup.md | 2 +-
docs/operate/reference/prepare/board1-setup.md | 2 +-
docs/operate/reference/prepare/jetson-agx-orin-setup.md | 2 +-
docs/operate/reference/prepare/jetson-nano-setup.md | 2 +-
docs/operate/reference/prepare/pumpkin.md | 2 +-
docs/operate/reference/prepare/rpi-setup.md | 2 +-
docs/operate/reference/prepare/sk-tda4vm.md | 2 +-
docs/tutorials/_index.md | 1 -
docs/tutorials/projects/_index.md | 2 +-
docs/tutorials/services/_index.md | 2 +-
layouts/docs/tutorials.html | 2 +-
layouts/partials/sidebar-tree.html | 2 +-
12 files changed, 11 insertions(+), 12 deletions(-)
diff --git a/docs/operate/reference/prepare/beaglebone-setup.md b/docs/operate/reference/prepare/beaglebone-setup.md
index fdad507838..9c3034b62f 100644
--- a/docs/operate/reference/prepare/beaglebone-setup.md
+++ b/docs/operate/reference/prepare/beaglebone-setup.md
@@ -95,5 +95,5 @@ You can find additional assistance in the [Troubleshooting section](/manage/trou
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/board1-setup.md b/docs/operate/reference/prepare/board1-setup.md
index 187350009b..809afb505f 100644
--- a/docs/operate/reference/prepare/board1-setup.md
+++ b/docs/operate/reference/prepare/board1-setup.md
@@ -72,5 +72,5 @@ You can find additional assistance in the [Troubleshooting section](/manage/trou
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/jetson-agx-orin-setup.md b/docs/operate/reference/prepare/jetson-agx-orin-setup.md
index b43ebb0a38..87b590b7a0 100644
--- a/docs/operate/reference/prepare/jetson-agx-orin-setup.md
+++ b/docs/operate/reference/prepare/jetson-agx-orin-setup.md
@@ -123,7 +123,7 @@ See NVIDIA's documentation on [Configuring the Jetson Expansion Headers](https:/
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{% card link="/dev/reference/sdks/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/jetson-nano-setup.md b/docs/operate/reference/prepare/jetson-nano-setup.md
index b10b918a70..faedf08762 100644
--- a/docs/operate/reference/prepare/jetson-nano-setup.md
+++ b/docs/operate/reference/prepare/jetson-nano-setup.md
@@ -111,7 +111,7 @@ See NVIDIA's documentation on [Configuring the Jetson Expansion Headers](https:/
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{% card link="/dev/reference/sdks/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/pumpkin.md b/docs/operate/reference/prepare/pumpkin.md
index 59ea59b6cd..110d03899f 100644
--- a/docs/operate/reference/prepare/pumpkin.md
+++ b/docs/operate/reference/prepare/pumpkin.md
@@ -255,7 +255,7 @@ Copy and paste the following json object into your board's attributes field.
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{% card link="/dev/reference/sdks/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/rpi-setup.md b/docs/operate/reference/prepare/rpi-setup.md
index 5075d543f0..55a1edf8fb 100644
--- a/docs/operate/reference/prepare/rpi-setup.md
+++ b/docs/operate/reference/prepare/rpi-setup.md
@@ -241,7 +241,7 @@ If you are using hardware that requires these protocols, you must enable support
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{% card link="/dev/reference/sdks/" %}}
{{< /cards >}}
diff --git a/docs/operate/reference/prepare/sk-tda4vm.md b/docs/operate/reference/prepare/sk-tda4vm.md
index 76abe6b761..6b0ebf6001 100644
--- a/docs/operate/reference/prepare/sk-tda4vm.md
+++ b/docs/operate/reference/prepare/sk-tda4vm.md
@@ -111,7 +111,7 @@ From the SSH session on the TDA4VM board:
{{< cards >}}
{{% card link="/operate/get-started/supported-hardware/" %}}
-{{% card link="/tutorials/" %}}
+{{% card link="/dev/tools/tutorials/" %}}
{{% card link="/dev/reference/sdks/" %}}
{{< /cards >}}
diff --git a/docs/tutorials/_index.md b/docs/tutorials/_index.md
index 3f4253f36e..91815c23b8 100644
--- a/docs/tutorials/_index.md
+++ b/docs/tutorials/_index.md
@@ -15,5 +15,4 @@ outputs:
- rss
- html
- typesense
-date: "2024-10-20"
---
diff --git a/docs/tutorials/projects/_index.md b/docs/tutorials/projects/_index.md
index 0492284f65..4ddc6cbee6 100644
--- a/docs/tutorials/projects/_index.md
+++ b/docs/tutorials/projects/_index.md
@@ -6,5 +6,5 @@ weight: 60
type: docs
empty_node: true
layout: "empty"
-canonical: "/tutorials/"
+canonical: "/dev/tools/tutorials/"
---
diff --git a/docs/tutorials/services/_index.md b/docs/tutorials/services/_index.md
index 33b9557933..a5e1a0673e 100644
--- a/docs/tutorials/services/_index.md
+++ b/docs/tutorials/services/_index.md
@@ -6,5 +6,5 @@ weight: 40
type: docs
empty_node: true
layout: "empty"
-canonical: "/tutorials/"
+canonical: "/dev/tools/tutorials/"
---
diff --git a/layouts/docs/tutorials.html b/layouts/docs/tutorials.html
index 0252c8d593..e659b3c1df 100644
--- a/layouts/docs/tutorials.html
+++ b/layouts/docs/tutorials.html
@@ -97,7 +97,7 @@ <h4 class="alert-heading">Javascript</h4>
</div>
</noscript>
</div>
- <p>Find more examples of how Viam is being used in the world by reviewing <a href="https://www.viam.com/customers" target="_blank">Customer Stories</a>, <a href="/tutorials/">tutorials</a>, or <a href="https://www.viam.com/blog?categories=Tutorials" target="_blank">blog posts</a>.</p>
+ <p>Find more examples of how Viam is being used in the world by reviewing <a href="https://www.viam.com/customers" target="_blank">Customer Stories</a> or <a href="https://www.viam.com/blog/build-and-learn" target="_blank">blog posts</a>.</p>
<button class="docsbutton" id="chatButton" title="Chatbot and support">
<span id="chatButtonContent">
diff --git a/layouts/partials/sidebar-tree.html b/layouts/partials/sidebar-tree.html
index 6c01ad8b24..569249a0cc 100644
--- a/layouts/partials/sidebar-tree.html
+++ b/layouts/partials/sidebar-tree.html
@@ -55,7 +55,7 @@
{{ if eq $p.Section "tutorials"}}
<!-- If this is a tutorial -->
-<a href="/tutorials/" target="{{ . }}" rel="noopener" class="">
+<a href="/dev/tools/tutorials/" target="{{ . }}" rel="noopener" class="">
<span> Tutorials </span>
</a>
<li class="active-path tutorial-heading">