diff --git a/doc/pics/ui-evaluation/kieskompas-0.png b/doc/pics/ui-evaluation/kieskompas-0.png
new file mode 100644
index 0000000..632346f
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-0.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-1.png b/doc/pics/ui-evaluation/kieskompas-1.png
new file mode 100644
index 0000000..db25922
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-1.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-2.png b/doc/pics/ui-evaluation/kieskompas-2.png
new file mode 100644
index 0000000..6a90351
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-2.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-3.png b/doc/pics/ui-evaluation/kieskompas-3.png
new file mode 100644
index 0000000..abf7c4d
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-3.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-4.png b/doc/pics/ui-evaluation/kieskompas-4.png
new file mode 100644
index 0000000..1edad23
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-4.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-5.png b/doc/pics/ui-evaluation/kieskompas-5.png
new file mode 100644
index 0000000..568bf9e
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-5.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-6.png b/doc/pics/ui-evaluation/kieskompas-6.png
new file mode 100644
index 0000000..b123bc0
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-6.png differ
diff --git a/doc/pics/ui-evaluation/kieskompas-7.png b/doc/pics/ui-evaluation/kieskompas-7.png
new file mode 100644
index 0000000..f2e0094
Binary files /dev/null and b/doc/pics/ui-evaluation/kieskompas-7.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-0.png b/doc/pics/ui-evaluation/stemwijzer-0.png
new file mode 100644
index 0000000..945df11
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-0.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-1.png b/doc/pics/ui-evaluation/stemwijzer-1.png
new file mode 100644
index 0000000..55c6f0c
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-1.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-2.png b/doc/pics/ui-evaluation/stemwijzer-2.png
new file mode 100644
index 0000000..0fa78d3
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-2.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-3.png b/doc/pics/ui-evaluation/stemwijzer-3.png
new file mode 100644
index 0000000..bea481f
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-3.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-4.png b/doc/pics/ui-evaluation/stemwijzer-4.png
new file mode 100644
index 0000000..1be19be
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-4.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-5.png b/doc/pics/ui-evaluation/stemwijzer-5.png
new file mode 100644
index 0000000..1491318
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-5.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-6.png b/doc/pics/ui-evaluation/stemwijzer-6.png
new file mode 100644
index 0000000..170a2e7
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-6.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-7.png b/doc/pics/ui-evaluation/stemwijzer-7.png
new file mode 100644
index 0000000..52eb860
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-7.png differ
diff --git a/doc/pics/ui-evaluation/stemwijzer-8.png b/doc/pics/ui-evaluation/stemwijzer-8.png
new file mode 100644
index 0000000..8586415
Binary files /dev/null and b/doc/pics/ui-evaluation/stemwijzer-8.png differ
diff --git a/doc/ui-evaluation.md b/doc/ui-evaluation.md
new file mode 100644
index 0000000..81031eb
--- /dev/null
+++ b/doc/ui-evaluation.md
@@ -0,0 +1,108 @@
+# UI evaluation
+
+This document evaluates the looks and user interface of existing voting platforms.
+
+## Netherlands
+The Netherlands has two prominent voting platforms, [Stemwijzer](https://stemwijzer.nl/) and [Kieskompas](https://kieskompas.nl).
+The Dutch system is heavily party-oriented, so the voting advice is based on parties and their party line.
+The voting is organized in [voting districts](https://nl.wikipedia.org/wiki/Kieskring).
+Some parties are only represented in a handful of the 19 Dutch voting districts, and are thereby ignored in the major voting platforms, as only a minority of the Dutch voters can actually vote for these parties.
+
+### Kieskompas
+
+The main page shows a distinct button to start filling in the questions, and a hashtag to use when referring to the platform in social media.
+The associated media outlets are featured at the page footer.
+The menu on the right opens up, enabling direct navigation all the steps, and a submenu with further details (disclaimer, privacy statement, guide and team).
+
+![](pics/ui-evaluation/kieskompas-0.png)
+
+To enable research and statistics, visitors are requested to fill in personal details, like their age.
+This request can be skipped.
+
+![](pics/ui-evaluation/kieskompas-1.png)
+
+Then we get to the questions, 30 in total.
+All statements offer 5 levels of agreement (totally agree, agree, neutral, disagree, totally disagree) and a 'no opinion' option.
+This interface has a strong focus on the question at hand.
+
+![](pics/ui-evaluation/kieskompas-2.png)
+
+The top menu offers the ability to see the progress, and navigate to other questions, including going back to previous questions.
+
+![](pics/ui-evaluation/kieskompas-3.png)
+
+By hovering over answers the details for that particular question are shown: what the question was, and what you answered.
+
+![](pics/ui-evaluation/kieskompas-4.png)
+
+Having answered all questions, the user is presented with a map of the political landscape first.
+This map is the origin of the name 'kieskompas' which means as much as 'voting compass', so to navigate the map of the political landscape.
+Most parties have a known generic stance on the axis of left-wing vs right-wing, and conservative vs progressive. As you might expect, left-wing and progressive are correlated, like right-wing and conservative.
+The position on the map is shown (not visible in the screenshot), and the party closest by (in the box lower right corner).
+The user can deselect some categories of questions, which displaces the location of the parties on the map a bit.
+
+![](pics/ui-evaluation/kieskompas-5.png)
+
+A ranking of similarities is offered as a second visualization.
+Again, certain categories can be turned on or off to influence the evaluation.
+
+![](pics/ui-evaluation/kieskompas-6.png)
+
+Lastly the stances of the parties can be evaluated.
+On the right hand side a category can be selected, and then a question from that category.
+All parties are displayed next to their answer.
+
+![](pics/ui-evaluation/kieskompas-7.png)
+
+
+### Stemwijzer
+
+The main page is pretty crowded, also highlighting other initiatives the organizers have going, including another voting platform called 'stemmentracker', which is based on the party behavior during the last reign period.
+
+![](pics/ui-evaluation/stemwijzer-0.png)
+
+Now we get to the main page we are aiming for.
+A short summary of the initiative is provided, and again a link to the other platform.
+All represented parties are shown on the side.
+One party does not have a formal stance, as it wants to pioneer liquid democracy by having party members vote on what the party should vote.
+
+![](pics/ui-evaluation/stemwijzer-1.png)
+
+There is a strong focus on the question at hand.
+Three choices are offered (agree, neither, disagree).
+Questions can be skipped, which is similar to a 'no opinion' option.
+When answering, the stances of parties can be viewed.
+The top shows a blue progress bar.
+
+![](pics/ui-evaluation/stemwijzer-2.png)
+
+Here the stances of parties are folded out.
+
+![](pics/ui-evaluation/stemwijzer-3.png)
+
+Just a small trip to the footer.
+Here the main steps of the evaluation process are shown, and navigation is possible.
+
+![](pics/ui-evaluation/stemwijzer-4.png)
+
+Having filled in all the questions, one can highlight questions which should be weighed more strongly.
+
+![](pics/ui-evaluation/stemwijzer-5.png)
+
+Then the user has to select which parties will be included in the evaluation.
+There are predefined selections for 'all parties' and for 'all parties currently in parliament'.
+
+![](pics/ui-evaluation/stemwijzer-6.png)
+
+The three most similar parties are finally presented.
+For these parties the similarity is shown.
+A total list of parties is shown further down the page, where the parties can be selected to take to the next step.
+The three most similar parties are preselected.
+
+![](pics/ui-evaluation/stemwijzer-7.png)
+
+Based on the previous selection of parties, all questions can be revisited.
+The stance of the user is shown, together with the stance of the selected parties.
+Other parties, not included in the selection, can be viewed on request.
+
+![](pics/ui-evaluation/stemwijzer-8.png)