From d93d4e6ca5a33c8ffbcceee204c39bad1ee81eba Mon Sep 17 00:00:00 2001
From: Valentin Gagarin <valentin@gagarin.work>
Date: Fri, 6 Sep 2024 13:51:07 +0200
Subject: [PATCH] clarify requirements for provisioning tutorial

---
 source/tutorials/nixos/binary-cache-setup.md   |  2 +-
 .../nixos/provisioning-remote-machines.md      | 18 ++++++++++++++++--
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/source/tutorials/nixos/binary-cache-setup.md b/source/tutorials/nixos/binary-cache-setup.md
index 0355197..8f1effb 100644
--- a/source/tutorials/nixos/binary-cache-setup.md
+++ b/source/tutorials/nixos/binary-cache-setup.md
@@ -9,7 +9,7 @@ myst:
 # Setting up an HTTP binary cache
 
 A binary cache stores pre-built [Nix store objects](https://nix.dev/manual/nix/latest/store/store-object) and provides them to other machines over the network.
-Any machine with a Nix store can be an binary cache for other machines.
+Any machine with a Nix store can be a binary cache for other machines.
 
 ## Introduction
 
diff --git a/source/tutorials/nixos/provisioning-remote-machines.md b/source/tutorials/nixos/provisioning-remote-machines.md
index f6cbd63..928dc83 100644
--- a/source/tutorials/nixos/provisioning-remote-machines.md
+++ b/source/tutorials/nixos/provisioning-remote-machines.md
@@ -13,7 +13,21 @@ It is possible to replace any Linux installation with a NixOS configuration on r
 [`nixos-anywhere`]: https://nix-community.github.io/nixos-anywhere/
 [`disko`]: https://github.com/nix-community/disko
 
-## Requirements
+## Introduction
+
+In this tutorial, you will deploy a NixOS configuration to a running computer.
+
+### What will you learn?
+
+You'll learn how to
+- Specify a minimal NixOS configuration with a declarative disk layout and SSH access
+- Check that a configuration is valid
+- Deploy and update a NixOS configuration on a remote machine
+
+### What do you need?
+
+- Familiarity with the [Nix language](reading-nix-language)
+- Familiarity with the [](module-system-tutorial)
 
 For a successful unattended installation, ensure for the *target machine* that:
 
@@ -96,7 +110,7 @@ Create a new file `single-disk-layout.nix` with the disk layout specification:
 
 {lineno-start=1}
 ```nix
-{ lib, ... }:
+{ ... }:
 
 {
   disko.devices.disk.main = {