From dfed17bb6c51c1c49164386e896663c75412ca0b Mon Sep 17 00:00:00 2001
From: Daniel Siepmann <coding@daniel-siepmann.de>
Date: Thu, 29 Jun 2017 08:42:38 +0200
Subject: [PATCH] TASK: Update docs

* Cover new features and how to use them.
---
 Documentation/source/features.rst | 41 +++++++++++++++++++++++++++++++
 Documentation/source/index.rst    |  1 +
 Documentation/source/usage.rst    | 27 ++++++++++++++++++++
 3 files changed, 69 insertions(+)
 create mode 100644 Documentation/source/features.rst

diff --git a/Documentation/source/features.rst b/Documentation/source/features.rst
new file mode 100644
index 0000000..c715512
--- /dev/null
+++ b/Documentation/source/features.rst
@@ -0,0 +1,41 @@
+.. _features:
+
+Features
+========
+
+The following features are currently provided:
+
+.. _features_indexing:
+
+Indexing
+--------
+
+Indexing data to Elasticsearch is provided. The extension delivers an indexer for TCA with zero
+configuration needs. Still it's possible to configure the indexer.
+
+Own indexer are not possible yet, but will.
+
+.. _features_search:
+
+Searching
+---------
+
+Currently all fields are searched for a single search input.
+
+Also multiple filter are supported. Filtering results by fields for string contents.
+
+.. _features_planned:
+
+Planned
+---------
+
+The following features are currently planned and will be integrated:
+
+#. Mapping Configuration
+   Allowing to configure the whole mapping, to define type of input, e.g. integer, keyword.
+
+
+#. Facets / Aggregates
+   Based on the mapping configuration, facets will be configurable and fetched. Therefore mapping is
+   required and we will adjust the result set to be of a custom model providing all information in a
+   more clean way.
diff --git a/Documentation/source/index.rst b/Documentation/source/index.rst
index dfda13b..5427fc9 100644
--- a/Documentation/source/index.rst
+++ b/Documentation/source/index.rst
@@ -7,6 +7,7 @@ Table of Contents
    :maxdepth: 1
    :glob:
 
+   features
    installation
    configuration
    usage
diff --git a/Documentation/source/usage.rst b/Documentation/source/usage.rst
index 1fc0e51..453b17d 100644
--- a/Documentation/source/usage.rst
+++ b/Documentation/source/usage.rst
@@ -37,3 +37,30 @@ Searching / Frontend Plugin
 
 To provide a search interface you can insert the frontend Plugin as normal content element of type
 plugin. The plugin is named *Search Core*.
+
+Please provide your own template, the extension will not deliver a useful template for now.
+
+The extbase mapping is used, this way you can create a form:
+
+.. code-block:: html
+
+   <f:form name="searchRequest" object="{searchRequest}">
+       <f:form.textfield property="query" />
+       <f:form.submit value="search" />
+   </f:form>
+
+.. _usage_searching_filter:
+
+Filter
+""""""
+
+Thanks to extbase mapping, filter are added to the form:
+
+.. code-block:: html
+   :emphasize-lines: 3
+
+   <f:form name="searchRequest" object="{searchRequest}">
+       <f:form.textfield property="query" />
+       <f:form.textfield property="filter.exampleName" value="the value to match" />
+       <f:form.submit value="search" />
+   </f:form>