Merge "Move 'User Refs' docs to the intro-user doc."
diff --git a/Documentation/intro-user.txt b/Documentation/intro-user.txt
index 4584841..b9bdad0 100644
--- a/Documentation/intro-user.txt
+++ b/Documentation/intro-user.txt
@@ -563,11 +563,23 @@
auto-merge on push] to benefit from the automatic merge/rebase on
server side while pushing directly into the repository.
+[[user-refs]]
+== User Refs
+
+User configuration data such as link:#preferences[preferences] is
+stored in the `All-Users` project under a per-user ref. The user's
+ref is based on the user's account id which is an integer. The user
+refs are sharded by the last two digits (`+nn+`) in the refname,
+leading to refs of the format `+refs/users/nn/accountid+`.
+
[[preferences]]
== Preferences
There are several options to control the rendering in the Gerrit web UI.
Users can configure their preferences under `Settings` > `Preferences`.
+The user's preferences are stored in a `git config` style file named
+`preferences.config` under the link:#user-refs[user's ref] in the
+`All-Users` project.
The following preferences can be configured:
diff --git a/Documentation/user-named-queries.txt b/Documentation/user-named-queries.txt
index 0ddbbef..e79b3da 100644
--- a/Documentation/user-named-queries.txt
+++ b/Documentation/user-named-queries.txt
@@ -3,15 +3,11 @@
[[user-named-queries]]
== User Named Queries
It is possible to define named queries on a user level. To do
-this, define the named queries in the `queries` file of
-the user's account ref in the `All-Users` project. The user's
-account ref is based on the user's account id which is an
-integer. The account refs are sharded by the last two digits
-(`+nn+`) in the refname, leading to refs of the format
-`+refs/users/nn/accountid+`. The user's queries file is a
-2 column tab delimited file. The left column represents the
-name of the query, and the right column represents the query
-expression represented by the name.
+this, define the named queries in the `queries` file under the
+link:intro-user.html#user-refs[user's ref] in the `All-Users` project. The
+user's queries file is a 2 column tab delimited file. The left
+column represents the name of the query, and the right column
+represents the query expression represented by the name.
Example queries file:
