From 9ad5aa7f8da72aa03a1c237e70ed78d6c0f54bcd Mon Sep 17 00:00:00 2001
From: Yuki Langley <hi@yukiisbo.red>
Date: Sun, 4 Jun 2023 20:48:52 +0700
Subject: [PATCH] Improve landing page

Closes https://github.com/NixOS/nix.dev/issues/535
---
 source/index.md                       | 36 +++++++++++++++++++++++----
 source/tutorials/first-steps/index.md |  2 ++
 2 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/source/index.md b/source/index.md
index 0f9c812ba..12c43b463 100644
--- a/source/index.md
+++ b/source/index.md
@@ -9,7 +9,37 @@ myst:
 
 # Welcome to nix.dev
 
-The Nix ecosystem is a DevOps toolkit to achieve:
+nix.dev is the home of official documentation for the Nix ecosystem, it contains:
+
+::::{grid} 2
+:::{grid-item-card} Tutorials
+:text-align: center
+Guided tour to the Nix ecosystem
+:::
+
+:::{grid-item-card} Recipes
+:text-align: center
+Guides to achieve a goal with the Nix ecosystem
+:::
+::::
+
+::::{grid} 2
+:::{grid-item-card} Reference
+:text-align: center
+Reference materials for details about the Nix ecosystem
+:::
+
+:::{grid-item-card} Concepts
+:text-align: center
+Articles explaining concepts and ideas found in the Nix ecosystem
+:::
+::::
+
+If you're new to the Nix ecosystem, begin your journey with {ref}`First Steps <first-steps>`!
+
+## What can you do with Nix?
+
+The following illustrate of what can be achieved with the Nix ecosystem:
 
 - {ref}`Reproducible development environments <ad-hoc-envs>`.
 - Easy installation of software over URLs.
@@ -25,10 +55,6 @@ The Nix ecosystem is a DevOps toolkit to achieve:
 - Remote deployments.
 - Atomic upgrades and rollbacks.
 
-This documentation supplements the official [Nix](http://nixos.org/nix/manual/),
-[NixOS](http://nixos.org/nixos/manual/), [Nixpkgs](http://nixos.org/nixpkgs/manual/)
-and [NixOps](http://nixos.org/nixops/manual/) manuals.
-
 ```{toctree}
 :glob:
 :caption: Tutorials
diff --git a/source/tutorials/first-steps/index.md b/source/tutorials/first-steps/index.md
index 91bcf3f92..cba952e3c 100644
--- a/source/tutorials/first-steps/index.md
+++ b/source/tutorials/first-steps/index.md
@@ -1,3 +1,5 @@
+(first-steps)=
+
 # First Steps
 
 This tutorial series is where you should start learning Nix.