docs/tour: move /docs/intro/tour to /docs/tour

This change moves the contents of /docs/introduction/tour from under the Introduction top-level container to a new (temporary) Tours container. It names the tour "The Basics of CUE". Its current unnamed state resulted from it being the /only/ tour that's imported from https://cuelang.org/docs/tutorials/. This change establishes the /docs/tour/ hierararchy as a temporary measure, designed to receive the other 4 tours from https://cuelang.org/docs/tutorials/, but with the intent to remove the top-level container as&when the Language Guide is able to replace the majority of the 5 tours. If there's any important content from those tours that's /not/ suitable for inclusion in the Language Guide, we can make a judgement call about moving that content to a more suitable location, or keeping the Tours hierarchy around. Hugo's auto-listing of sub-pages is put to reasonably good use, by prefixing it with an H2 that makes the list look more like part of the same page than before the change. This approach will be used throughout the process of importing the additional 4 tours from cuelang.org. For cue-lang/docs-and-content#25 Preview-Path: /docs/tour/ Preview-Path: /docs/tour/basics/ Signed-off-by: Jonathan Matthews <[email protected]> Change-Id: I7cc5e0de7f653404533ac85aa45fe812aaa630e6 Dispatch-Trailer: {"type":"trybot","CL":1171468,"patchset":1,"ref":"refs/changes/68/1171468/1","targetBranch":"alpha"}
cue-lang · Oct 31, 2023 · 845681f · 845681f
1 parent 3591d71
commit 845681f
Show file tree

Hide file tree

Showing 40 changed files with 75 additions and 49 deletions.
diff --git a/content/docs/introduction/tour/_en.md b/content/docs/introduction/tour/_en.md
diff --git a/content/docs/introduction/tour/constraints/page.cue b/content/docs/introduction/tour/constraints/page.cue
diff --git a/content/docs/introduction/tour/definitions/page.cue b/content/docs/introduction/tour/definitions/page.cue
diff --git a/content/docs/introduction/tour/duplicate-fields/page.cue b/content/docs/introduction/tour/duplicate-fields/page.cue
diff --git a/content/docs/introduction/tour/folding-structs/page.cue b/content/docs/introduction/tour/folding-structs/page.cue
diff --git a/content/docs/introduction/tour/json-superset/page.cue b/content/docs/introduction/tour/json-superset/page.cue
diff --git a/content/docs/introduction/tour/order-irrelevance/page.cue b/content/docs/introduction/tour/order-irrelevance/page.cue
diff --git a/content/docs/introduction/tour/page.cue b/content/docs/introduction/tour/page.cue
diff --git a/content/docs/introduction/tour/types-are-values/page.cue b/content/docs/introduction/tour/types-are-values/page.cue
diff --git a/content/docs/introduction/tour/validation/page.cue b/content/docs/introduction/tour/validation/page.cue
diff --git a/content/docs/tour/_en.md b/content/docs/tour/_en.md
@@ -0,0 +1,16 @@
+---
+title: Tours
+weight: 15
+---
+
+{{< info >}}
+These tours of CUE are being actively developed, and their contents may migrate
+into other sections of the CUE documentation site over time. In particular the
+[Language Guide]({{< relref "language-guide.md" >}}) will provide a deep dive
+into CUE, covering many of the topics currently included in these tours.
+{{< /info >}}
+
+If you're new to CUE, get a quick start with a tour of
+[the basics of CUE]({{< relref "basics" >}}), or select a different tour.
+
+## Available Tours
diff --git a/content/docs/tour/basics/_en.md b/content/docs/tour/basics/_en.md
@@ -0,0 +1,8 @@
+---
+title: "The Basics of CUE"
+---
+
+This tour demonstrates the simplest ideas and syntax you'll use when reading
+and writing CUE.
+
+## Contents
diff --git a/.../docs/introduction/tour/constraints/en.md → content/docs/tour/basics/constraints/en.md b/.../docs/introduction/tour/constraints/en.md → content/docs/tour/basics/constraints/en.md
diff --git a/content/docs/tour/basics/constraints/page.cue b/content/docs/tour/basics/constraints/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "constraints": {}
diff --git a/.../docs/introduction/tour/definitions/en.md → content/docs/tour/basics/definitions/en.md b/.../docs/introduction/tour/definitions/en.md → content/docs/tour/basics/definitions/en.md
diff --git a/content/docs/tour/basics/definitions/page.cue b/content/docs/tour/basics/definitions/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "definitions": {}
diff --git a/.../introduction/tour/duplicate-fields/en.md → ...t/docs/tour/basics/duplicate-fields/en.md b/.../introduction/tour/duplicate-fields/en.md → ...t/docs/tour/basics/duplicate-fields/en.md
diff --git a/content/docs/tour/basics/duplicate-fields/page.cue b/content/docs/tour/basics/duplicate-fields/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "duplicate-fields": {}
diff --git a/...s/introduction/tour/folding-structs/en.md → ...nt/docs/tour/basics/folding-structs/en.md b/...s/introduction/tour/folding-structs/en.md → ...nt/docs/tour/basics/folding-structs/en.md
diff --git a/content/docs/tour/basics/folding-structs/page.cue b/content/docs/tour/basics/folding-structs/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "folding-structs": {}
diff --git a/...ocs/introduction/tour/json-superset/en.md → content/docs/tour/basics/json-superset/en.md b/...ocs/introduction/tour/json-superset/en.md → content/docs/tour/basics/json-superset/en.md
diff --git a/content/docs/tour/basics/json-superset/page.cue b/content/docs/tour/basics/json-superset/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "json-superset": {}
diff --git a/...introduction/tour/order-irrelevance/en.md → .../docs/tour/basics/order-irrelevance/en.md b/...introduction/tour/order-irrelevance/en.md → .../docs/tour/basics/order-irrelevance/en.md
diff --git a/content/docs/tour/basics/order-irrelevance/page.cue b/content/docs/tour/basics/order-irrelevance/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "order-irrelevance": {}
diff --git a/content/docs/tour/basics/page.cue b/content/docs/tour/basics/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: {}
diff --git a/.../introduction/tour/types-are-values/en.md → ...t/docs/tour/basics/types-are-values/en.md b/.../introduction/tour/types-are-values/en.md → ...t/docs/tour/basics/types-are-values/en.md
diff --git a/content/docs/tour/basics/types-are-values/page.cue b/content/docs/tour/basics/types-are-values/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "types-are-values": {}
diff --git a/...t/docs/introduction/tour/validation/en.md → content/docs/tour/basics/validation/en.md b/...t/docs/introduction/tour/validation/en.md → content/docs/tour/basics/validation/en.md
diff --git a/content/docs/tour/basics/validation/page.cue b/content/docs/tour/basics/validation/page.cue
@@ -0,0 +1,3 @@
+package site
+
+content: docs: tour: basics: "validation": {}
diff --git a/hugo/content/en/docs/introduction/tour/_index.md b/hugo/content/en/docs/introduction/tour/_index.md
diff --git a/hugo/content/en/docs/tour/_index.md b/hugo/content/en/docs/tour/_index.md
@@ -0,0 +1,16 @@
+---
+title: Tours
+weight: 15
+---
+
+{{< info >}}
+These tours of CUE are being actively developed, and their contents may migrate
+into other sections of the CUE documentation site over time. In particular the
+[Language Guide]({{< relref "language-guide.md" >}}) will provide a deep dive
+into CUE, covering many of the topics currently included in these tours.
+{{< /info >}}
+
+If you're new to CUE, get a quick start with a tour of
+[the basics of CUE]({{< relref "basics" >}}), or select a different tour.
+
+## Available Tours
diff --git a/hugo/content/en/docs/tour/basics/_index.md b/hugo/content/en/docs/tour/basics/_index.md
@@ -0,0 +1,8 @@
+---
+title: "The Basics of CUE"
+---
+
+This tour demonstrates the simplest ideas and syntax you'll use when reading
+and writing CUE.
+
+## Contents
diff --git a/...cs/introduction/tour/constraints/index.md → .../en/docs/tour/basics/constraints/index.md b/...cs/introduction/tour/constraints/index.md → .../en/docs/tour/basics/constraints/index.md
diff --git a/...cs/introduction/tour/definitions/index.md → .../en/docs/tour/basics/definitions/index.md b/...cs/introduction/tour/definitions/index.md → .../en/docs/tour/basics/definitions/index.md
diff --git a/...troduction/tour/duplicate-fields/index.md → ...ocs/tour/basics/duplicate-fields/index.md b/...troduction/tour/duplicate-fields/index.md → ...ocs/tour/basics/duplicate-fields/index.md
diff --git a/...ntroduction/tour/folding-structs/index.md → ...docs/tour/basics/folding-structs/index.md b/...ntroduction/tour/folding-structs/index.md → ...docs/tour/basics/folding-structs/index.md
diff --git a/.../introduction/tour/json-superset/index.md → ...n/docs/tour/basics/json-superset/index.md b/.../introduction/tour/json-superset/index.md → ...n/docs/tour/basics/json-superset/index.md
diff --git a/...roduction/tour/order-irrelevance/index.md → ...cs/tour/basics/order-irrelevance/index.md b/...roduction/tour/order-irrelevance/index.md → ...cs/tour/basics/order-irrelevance/index.md
diff --git a/...troduction/tour/types-are-values/index.md → ...ocs/tour/basics/types-are-values/index.md b/...troduction/tour/types-are-values/index.md → ...ocs/tour/basics/types-are-values/index.md
diff --git a/...ocs/introduction/tour/validation/index.md → ...t/en/docs/tour/basics/validation/index.md b/...ocs/introduction/tour/validation/index.md → ...t/en/docs/tour/basics/validation/index.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "constraints": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "definitions": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "duplicate-fields": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "folding-structs": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "json-superset": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "order-irrelevance": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "types-are-values": {}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		package site

		content: docs: tour: basics: "validation": {}