[IMP] add screenshot, example in README

web_widget_x2many_2d_matrix/README.rst

@@ -4,16 +4,22 @@
 This module allows to show an x2many field with 3-tuples
 ($x_value, $y_value, $value) in a table
 
-+-----------+-----------+-----------+
+          $x_value1   $x_value2 
-|           | $x_value1 | $x_value2 |
+========= =========== ===========
-+===========+===========+===========+
+$y_value1 $value(1/1) $value(2/1)
-| $y_value1 | $value1/1 | $value2/1 |
+$y_value2 $value(1/2) $value(2/2)
-+-----------+-----------+-----------+
+========= =========== ===========
-| $y_value2 | $value1/2 | $value2/2 |
-+-----------+-----------+-----------+
 
-where `valuen/n` is editable.
+where `value(n/n)` is editable.
 
+An example use case would be: Select some projects and some employees so that
+a manager can easily fill in the planned_hours for one task per employee. The
+result could look like this:
+
+.. image:: /web_widget_x2many_2d_matrix/static/description/screenshot.png
+    :alt: Screenshot
+
+The beauty of this is that you have an arbitrary amount of columns with this widget, trying to get this in standard x2many lists involves some quite agly hacks.
 
 Usage
 =====
@@ -26,8 +32,7 @@ This assumes that my_field refers to a model with the fields `x`, `y` and
 `value`. If your fields are named differently, pass the correct names as
 attributes::
 
-<field name="my_field" widget="x2many_2d_matrix"
+<field name="my_field" widget="x2many_2d_matrix" field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3" />
- field_x_axis="my_field1" field_y_axis="my_field2" field_value="my_field3" />
 
 You can pass the following parameters: