diff --git a/README.md b/README.md index e5ce90dab68..241eeed11b6 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! - -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. +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. + +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