From f20ba2341280c29cc956583a073322f94cdc5898 Mon Sep 17 00:00:00 2001
From: Patrick McDermott <pehjota>
Date: Sat, 26 Dec 2020 13:03:41 -0500
Subject: doc/install: Explain when to use chroot or hw

---
(limited to 'doc/install.mdwn')

diff --git a/doc/install.mdwn b/doc/install.mdwn
index 533040b..11b364a 100644
--- a/doc/install.mdwn
+++ b/doc/install.mdwn
@@ -8,9 +8,15 @@ install and manage ProteanOS systems.  [[Get_started!_→|doc/install/prokit]]
 
 Then, choose how and where to install ProteanOS:
 
-  * [[In_an_isolated_file_system_environment_→|doc/install/chroot]]
+  * [[On_an_existing_host_system_under_an_isolated_file_system_environment_→|doc/install/chroot]]
   * [[On_a_supported_PC_→|doc/install/pc]]
 
+ProteanOS package development is typically done on an different host system.
+Running ProteanOS on actual hardware is only necessary for testing things like
+hardware-specific features (e.g. booting with a new `linux-image-*` package),
+network configuration, or system services (e.g. a logging daemon or a Web
+server).
+
 See the [[legal_and_technical_notices|doc/legal]] to learn how to find copyright
 information for ProteanOS packages and how to build ProteanOS packages from
 source code.
--
cgit v0.9.1