# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
# Date 1427918017 -7200
# Node ID daa83b2dd1f40b1b901843a0d73bdabd4a18cd21
# Parent  35d560f0f842cab98ed6972573addcc2aeeac01c
docs/usage: rework and rename section 'Visual settings in admin pannel'

- remove trivial items that are already explained on the settings page
  itself
- rename section to reflect this new scope
- general rewording

diff -r 35d560f0f842 -r daa83b2dd1f4 docs/usage/general.rst
--- a/docs/usage/general.rst	Wed Apr 01 21:31:19 2015 +0200
+++ b/docs/usage/general.rst	Wed Apr 01 21:53:37 2015 +0200
@@ -119,47 +119,32 @@
 
 
 
-Visual settings in admin pannel
--------------------------------
-
+Specific features configurable in the Admin settings
+----------------------------------------------------
 
-Visualisation settings in Kallithea settings view are extra customizations
-of server behavior. There are 3 main sections in the settings.
+In general, the Admin settings should be self-explanatory and will not be
+described in more detail in this documentation. However, there are a few
+features that merit further explanation.
 
-General
-~~~~~~~
+Repository extra fields
+~~~~~~~~~~~~~~~~~~~~~~~
 
-The `Use repository extra fields` option allows to set a custom fields
-for each repository in the system. Each new field consists of 3
-attributes: ``field key``, ``field label``, ``field
-description``. Example usage of such fields would be to define company
-specific information into repositories, e.g., defining a
-``repo_manager`` key that would give info about a manager of each
-repository. There's no limit for adding custom fields. Newly created
-fields are accessible via API.
-
-The `Show Kallithea version` option toggles displaying the exact
-Kallithea version in the footer
-
+In the `Visual` tab, there is an option `Use repository extra
+fields`, which allows to set custom fields for each repository in the system.
+Each new field consists of 3 attributes: ``field key``, ``field label``,
+``field description``.
 
-Dashboard items
-~~~~~~~~~~~~~~~
-
-Number of items in main page dashboard before pagination is displayed.
-
-
-Icons
-~~~~~
-
-Show public repo icon / Show private repo icon on repositories - defines if
-public/private icons should be shown in the UI.
-
+Example usage of such fields would be to define company-specific information
+into repositories, e.g., defining a ``repo_manager`` key that would give info
+about a manager of each repository.  There's no limit for adding custom fields.
+Newly created fields are accessible via the API.
 
 Meta-Tagging
 ~~~~~~~~~~~~
 
-With this option enabled, special metatags that are recognisible by Kallithea
-will be turned into colored tags. Currently available tags are::
+In the `Visual` tab, option `Stylify recognised meta tags` will cause Kallithea
+to turn certain meta-tags, detected in repository and repository group
+descriptions, into colored tags. Currently recognised tags are::
 
     [featured]
     [stale]