From cb1ed0d2f324c38290eae180be22e5cfd0c77494 Mon Sep 17 00:00:00 2001 From: Robert Helgesson Date: Sat, 9 Jan 2021 10:04:44 +0100 Subject: [PATCH] docs: rephrase warning section slightly --- README.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index e5ce90da..241eeed1 100644 --- a/README.md +++ b/README.md @@ -14,14 +14,17 @@ options, please see the [Home Manager manual][manual]. Words of warning ---------------- -This project is under development. I personally use it to manage -several user configurations but it may fail catastrophically for you. -So beware! +Unfortunately, it is quite possible to get difficult to understand +errors when working with Home Manager, such as infinite loops with no +clear source reference. You should therefore be comfortable using the +Nix language and the various tools in the Nix ecosystem. Reading +through the [Nix Pills][] document is a good way to familiarize +yourself with them. -Before using Home Manager you should be comfortable using the Nix -language and the various tools in the Nix ecosystem. Reading through -the [Nix Pills][] document is a good way to familiarize yourself with -them. +If you are not very familiar with Nix but still want to use Home +Manager then you are strongly encouraged to start with a small and +very simple configuration and gradually make it more elaborate as you +learn. In some cases Home Manager cannot detect whether it will overwrite a previous manual configuration. For example, the Gnome Terminal module