From 80a3a2a7708d6a3c5f1962e5ce0c0720a6d7beb2 Mon Sep 17 00:00:00 2001
From: Janos Bonic <86970079+janosdebugs@users.noreply.github.com>
Date: Wed, 20 Mar 2024 15:25:55 +0100
Subject: [PATCH 1/3] Restructured front page

Signed-off-by: Janos Bonic <86970079+janosdebugs@users.noreply.github.com>
---
 docusaurus.config.ts                |  8 +++---
 download.mdx                        |  0
 src/components/GetStarted/index.tsx | 42 +++++++++++++++++++++++++++++
 src/components/Hero/index.tsx       | 12 ++++-----
 src/components/Home/index.tsx       |  8 ++----
 5 files changed, 54 insertions(+), 16 deletions(-)
 create mode 100644 download.mdx
 create mode 100644 src/components/GetStarted/index.tsx

diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index ef8c8033..d9ba8d68 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -245,13 +245,13 @@ const config: Config = {
       hideOnScroll: true,
       items: [
         {
-          to: "/manifesto",
-          label: "Manifesto",
+          to: "/getting-started",
+          label: "Getting started",
           position: "left",
         },
         {
-          to: "/supporters",
-          label: "Supporters",
+          to: "/download",
+          label: "Download",
           position: "left",
         },
         {
diff --git a/download.mdx b/download.mdx
new file mode 100644
index 00000000..e69de29b
diff --git a/src/components/GetStarted/index.tsx b/src/components/GetStarted/index.tsx
new file mode 100644
index 00000000..67116b00
--- /dev/null
+++ b/src/components/GetStarted/index.tsx
@@ -0,0 +1,42 @@
+import React from "react";
+
+
+
+export default function GetStarted() {
+    return (
+        <section className="py-12 mx-auto container items-center flex flex-col px-4">
+            <h2 className="text-center text-3xl md:text-5xl font-bold mb-4 md:mb-7">
+                Which of these best describes you?
+            </h2>
+            <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
+                <div className="bg-white dark:bg-blue-900 p-6">
+                    <h3 className="text-xl mb-2">I want a high-level overview</h3>
+                    <p className="text-gray-600 dark:text-gray-500">
+                        Learn the fundamentals of Infrastructure-as-Code in
+                        this high level guide, understand why IaC is so powerful, and how OpenTofu can help.
+                    </p>
+                </div>
+                <div className="bg-white dark:bg-blue-900 p-6">
+                    <h3 className="text-xl mb-2">I'm new to OpenTofu</h3>
+                    <p className="text-gray-600 dark:text-gray-500">
+                        For newcomers to infrastructure as code an OpenTofu, this hands-on guide runs you through the
+                        basics of creating your first server with OpenTofu.
+                    </p>
+                </div>
+                <div className="bg-white dark:bg-blue-900 p-6">
+                    <h3 className="text-xl mb-2">I'm migrating from Terraform</h3>
+                    <p className="text-gray-600 dark:text-gray-500">
+                        If you already have experience with Terraform but want to migrate to OpenTofu, this is for you.
+                        Tried and tested migration paths from Terraform to OpenTofu.
+                    </p>
+                </div>
+                <div className="bg-white dark:bg-blue-900 p-6">
+                    <h3 className="text-xl mb-2">Just give me the docs</h3>
+                    <p className="text-gray-600 dark:text-gray-500">
+                        Reference manual for those in need of a quick lookup.
+                    </p>
+                </div>
+            </div>
+        </section>
+    );
+}
diff --git a/src/components/Hero/index.tsx b/src/components/Hero/index.tsx
index 26e1e1b8..4f1d7683 100644
--- a/src/components/Hero/index.tsx
+++ b/src/components/Hero/index.tsx
@@ -33,16 +33,16 @@ export default function Hero() {
         The open source infrastructure as code tool.
       </Headline>
       <p className="my-6 text-xl sm:max-w-lg md:max-w-xl lg:max-w-2xl text-center text-gray-600 dark:text-gray-500">
-        Previously named OpenTF, OpenTofu is a fork of Terraform that is
-        open-source, community-driven, and managed by the Linux Foundation.
+        OpenTofu is a community-driven infrastructure-as-code tool that lets you
+          declaratively create and manage your cloud infrastructure.
       </p>
 
       <div className="flex gap-4 pt-6">
-        <Button className="text-center" variant="secondary" href="/manifesto">
-          Read Manifesto
+        <Button className="text-center" variant="secondary" href="/getting-started">
+          Getting started
         </Button>
-        <Button variant="primary" href="/docs/intro/install">
-          Try it out
+        <Button variant="primary" href="/download">
+          Download
         </Button>
       </div>
     </header>
diff --git a/src/components/Home/index.tsx b/src/components/Home/index.tsx
index 91e98295..e23780a1 100644
--- a/src/components/Home/index.tsx
+++ b/src/components/Home/index.tsx
@@ -1,18 +1,14 @@
 import React from "react";
 import Layout from "@theme/Layout";
 import Hero from "../Hero";
-import Goals from "../Goals";
 import Supporters from "../Supporters";
-import FAQ from "../FAQ";
-import HowToContribute from "../HowToContribute";
+import GetStarted from "../GetStarted";
 
 export default function Home() {
   return (
     <Layout description="The open source infrastructure as code tool.">
       <Hero />
-      <Goals />
-      <HowToContribute />
-      <FAQ />
+      <GetStarted />
       <Supporters />
     </Layout>
   );

From d09c15cc6f1ebc37672ae5063c94793ee0c39562 Mon Sep 17 00:00:00 2001
From: Janos <86970079+janosdebugs@users.noreply.github.com>
Date: Mon, 6 May 2024 08:25:04 +0200
Subject: [PATCH 2/3] Testing structure

Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com>
---
 docusaurus.config.ts               | 18 +++++++++++++
 download.mdx => download/index.mdx |  0
 download/sidebars.json             |  8 ++++++
 getting-started/chapter1/deb.mdx   |  4 +++
 getting-started/chapter1/index.mdx | 41 ++++++++++++++++++++++++++++++
 getting-started/index.mdx          | 12 +++++++++
 getting-started/sidebars.json      |  8 ++++++
 7 files changed, 91 insertions(+)
 rename download.mdx => download/index.mdx (100%)
 create mode 100644 download/sidebars.json
 create mode 100644 getting-started/chapter1/deb.mdx
 create mode 100644 getting-started/chapter1/index.mdx
 create mode 100644 getting-started/index.mdx
 create mode 100644 getting-started/sidebars.json

diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index d9ba8d68..a5875a4b 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -139,6 +139,24 @@ const config: Config = {
   ],
 
   plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'getting-started',
+        path: 'getting-started',
+        routeBasePath: 'getting-started',
+        sidebarPath: './getting-started/sidebars.json',
+      },
+    ],
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'download',
+        path: 'download',
+        routeBasePath: 'download',
+        sidebarPath: './download/sidebars.json',
+      },
+    ],
     "./plugins/blog-plugin",
     function tailwindPlugin() {
       return {
diff --git a/download.mdx b/download/index.mdx
similarity index 100%
rename from download.mdx
rename to download/index.mdx
diff --git a/download/sidebars.json b/download/sidebars.json
new file mode 100644
index 00000000..740c69b1
--- /dev/null
+++ b/download/sidebars.json
@@ -0,0 +1,8 @@
+{
+  "download": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}
\ No newline at end of file
diff --git a/getting-started/chapter1/deb.mdx b/getting-started/chapter1/deb.mdx
new file mode 100644
index 00000000..fa8afe82
--- /dev/null
+++ b/getting-started/chapter1/deb.mdx
@@ -0,0 +1,4 @@
+---
+sidebar_label: ".deb-based systems"
+sidebar_position: 1
+---
\ No newline at end of file
diff --git a/getting-started/chapter1/index.mdx b/getting-started/chapter1/index.mdx
new file mode 100644
index 00000000..0db221c9
--- /dev/null
+++ b/getting-started/chapter1/index.mdx
@@ -0,0 +1,41 @@
+---
+sidebar_label: "Chapter 1: Setting up OpenTofu"
+sidebar_position: 2
+---
+
+# Chapter 1: Setting up OpenTofu
+
+OpenTofu is a single, static binary. This means you can download the .zip/.tar.gz file [from GitHub](https://github.com/opentofu/opentofu/releases) and use it out of the box, no installation is required. However, we maintain a list of [installation methods](/download/) that allow you to easily update your OpenTofu installation in the future.
+
+To get started, please select your operating system below.
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs>
+    <TabItem value="linux" label="Linux" default>
+        <Tabs>
+            <TabItem value="deb" label={<span>.deb-based systems<br /><small>(Debian & derivatives)</small></span>} default>
+
+            </TabItem>
+            <TabItem value="rpm" label={<span>.rpm-based systems<br /><small>(RHEL, SUSE, etc)</small></span>}>
+
+            </TabItem>
+            <TabItem value="alpine" label="Alpine Linux">
+
+            </TabItem>
+            <TabItem value="other" label="Other distributions">
+
+            </TabItem>
+        </Tabs>
+    </TabItem>
+    <TabItem value="Windows" label="Windows">
+        Windows
+    </TabItem>
+    <TabItem value="MacOS" label="MacOS">
+        MacOS
+    </TabItem>
+    <TabItem value="UNIX/BSD" label="UNIX/BSD">
+        Unix/BSD
+    </TabItem>
+</Tabs>
\ No newline at end of file
diff --git a/getting-started/index.mdx b/getting-started/index.mdx
new file mode 100644
index 00000000..15357dad
--- /dev/null
+++ b/getting-started/index.mdx
@@ -0,0 +1,12 @@
+---
+sidebar_label: Overview
+sidebar_position: 1
+---
+
+# Getting started with OpenTofu
+
+Welcome to OpenTofu! If you are new to OpenTofu or infrastructure-as-code, this section is for you. It is a practical, hands-on introduction to getting your first cloud infrastructure going.
+
+This guide is structured into the following parts:
+
+- [Chapter 1: Setting up OpenTofu](./chapter1/index.mdx)
\ No newline at end of file
diff --git a/getting-started/sidebars.json b/getting-started/sidebars.json
new file mode 100644
index 00000000..e286d951
--- /dev/null
+++ b/getting-started/sidebars.json
@@ -0,0 +1,8 @@
+{
+  "guides": [
+    {
+      "type": "autogenerated",
+      "dirName": "."
+    }
+  ]
+}
\ No newline at end of file

From 45739ce070c603b72ce1488cdb569afc6eedb826 Mon Sep 17 00:00:00 2001
From: Damian Stasik <920747+damianstasik@users.noreply.github.com>
Date: Tue, 14 May 2024 12:47:50 +0200
Subject: [PATCH 3/3] Make cards clickable

Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com>
---
 src/components/GetStarted/index.tsx | 86 ++++++++++++++++-------------
 1 file changed, 49 insertions(+), 37 deletions(-)

diff --git a/src/components/GetStarted/index.tsx b/src/components/GetStarted/index.tsx
index 67116b00..0a5e2d09 100644
--- a/src/components/GetStarted/index.tsx
+++ b/src/components/GetStarted/index.tsx
@@ -1,42 +1,54 @@
+import Link from "@docusaurus/Link";
 import React from "react";
 
-
+function LinkCard({
+  title,
+  description,
+  path,
+}: {
+  title: string;
+  description: string;
+  path: string;
+}) {
+  return (
+    <div className="bg-white dark:bg-blue-900 p-6 relative flex flex-col gap-2 ">
+      <Link to={path} className="text-xl">
+        <span className="absolute inset-0"></span>
+        {title}
+      </Link>
+      <p className="text-gray-600 dark:text-gray-500">{description}</p>
+    </div>
+  );
+}
 
 export default function GetStarted() {
-    return (
-        <section className="py-12 mx-auto container items-center flex flex-col px-4">
-            <h2 className="text-center text-3xl md:text-5xl font-bold mb-4 md:mb-7">
-                Which of these best describes you?
-            </h2>
-            <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
-                <div className="bg-white dark:bg-blue-900 p-6">
-                    <h3 className="text-xl mb-2">I want a high-level overview</h3>
-                    <p className="text-gray-600 dark:text-gray-500">
-                        Learn the fundamentals of Infrastructure-as-Code in
-                        this high level guide, understand why IaC is so powerful, and how OpenTofu can help.
-                    </p>
-                </div>
-                <div className="bg-white dark:bg-blue-900 p-6">
-                    <h3 className="text-xl mb-2">I'm new to OpenTofu</h3>
-                    <p className="text-gray-600 dark:text-gray-500">
-                        For newcomers to infrastructure as code an OpenTofu, this hands-on guide runs you through the
-                        basics of creating your first server with OpenTofu.
-                    </p>
-                </div>
-                <div className="bg-white dark:bg-blue-900 p-6">
-                    <h3 className="text-xl mb-2">I'm migrating from Terraform</h3>
-                    <p className="text-gray-600 dark:text-gray-500">
-                        If you already have experience with Terraform but want to migrate to OpenTofu, this is for you.
-                        Tried and tested migration paths from Terraform to OpenTofu.
-                    </p>
-                </div>
-                <div className="bg-white dark:bg-blue-900 p-6">
-                    <h3 className="text-xl mb-2">Just give me the docs</h3>
-                    <p className="text-gray-600 dark:text-gray-500">
-                        Reference manual for those in need of a quick lookup.
-                    </p>
-                </div>
-            </div>
-        </section>
-    );
+  return (
+    <section className="py-12 mx-auto container items-center flex flex-col px-4">
+      <h2 className="text-center text-3xl md:text-5xl font-bold mb-4 md:mb-7">
+        Which of these best describes you?
+      </h2>
+      <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
+        <LinkCard
+          title="I want a high-level overview"
+          description="Learn the fundamentals of Infrastructure-as-Code in this high level guide, understand why IaC is so powerful, and how OpenTofu can help."
+          path="/test1"
+        />
+        <LinkCard
+          title="I'm new to OpenTofu"
+          description="For newcomers to infrastructure as code an OpenTofu, this hands-on guide runs you through the basics of creating your first server with OpenTofu."
+          path="/test2"
+        />
+        <LinkCard
+          title="I'm migrating from Terraform"
+          description="If you already have experience with Terraform but want to migrate to OpenTofu, this is for you. Tried and tested migration paths from Terraform to OpenTofu."
+          path="/test3"
+        />
+        <LinkCard
+          title="Just give me the docs"
+          description="Reference manual for those in need of a quick lookup."
+          path="/test4"
+        />
+      </div>
+    </section>
+  );
 }