# HG changeset patch
# User Marcin Kuzminski <marcin@rhodecode.com>
# Date 2017-06-23 13:06:22
# Node ID d665f40fb967a82457656d7f57b0d8e22af66a2d
# Parent  eb2b308f8fd79dd4fd8337e5af2fe0a3f7ceb4e6

docs: updated repo extra fields documentation.

diff --git a/docs/admin/repo-extra-fields.rst b/docs/admin/repo-extra-fields.rst
--- a/docs/admin/repo-extra-fields.rst
+++ b/docs/admin/repo-extra-fields.rst
@@ -3,8 +3,12 @@
 Repository Extra Fields
 =======================
 
-Extra fields attached to a |repo| allow you to configure additional actions for
-|RCX|. To install and read more about |RCX|, see the :ref:`install-rcx` section.
+Extra fields attached to a |repo| allow you to configure additional fields for
+each repository. This allows storing custom data per-repository.
+
+It can be used in :ref:`integrations-webhook` or in |RCX|.
+To install and read more about |RCX|, see the :ref:`install-rcx` section.
+
 
 Enabling Extra Fields
 ---------------------
@@ -27,9 +31,14 @@ 2. On the |repo| settings page, select t
 
 .. image:: ../images/extra-repo-fields.png
 
+The most important is the `New field key` variable which under the value will
+be stored. It needs to be unique for each repository. The label and description
+will be generated in repository settings where users can actually save some
+values inside generated extra fields.
 
-Example Usage
--------------
+
+Example Usage in extensions
+---------------------------
 
 To use the extra fields in an extension, see the example below. For more
 information and examples, see the :ref:`extensions-hooks-ref` section.