docs: rephrase warning section slightly

(cherry picked from commit cb1ed0d2f3)
This commit is contained in:
Robert Helgesson 2021-01-09 10:04:44 +01:00
parent 2c7a2f8084
commit 392c3da3fe
No known key found for this signature in database
GPG key ID: 36BDAA14C2797E89

View file

@ -12,14 +12,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