diff --git a/.eslintrc.js b/.eslintrc.js
index b7b953d..8e5a99a 100644
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -22,8 +22,16 @@ module.exports = {
         'no-console': 0,
       },
     },
+    /**
+     * exclude jest plugin in cypress files, because test are written
+     * differently and `expect` is typed different.
+     */
     {
-      files: ['./cypress/**/*.ts', './src/**/__cypress__/*.tsx'],
+      files: [
+        './cypress/**/*.ts',
+        './cypress/**/*.tsx',
+        './src/**/__cypress__/*.tsx',
+      ],
       extends: ['plugin:cypress/recommended'],
       rules: {
         'jest/expect-expect': 0,
diff --git a/cypress/integration/app/Navigation.spec.ts b/cypress/integration/app/Navigation.spec.ts
index 19a2634..8d49e07 100644
--- a/cypress/integration/app/Navigation.spec.ts
+++ b/cypress/integration/app/Navigation.spec.ts
@@ -1,3 +1,6 @@
+/**
+ * TODO: document when and how to use reference types
+ */
 /// <reference types="../../support" />
 
 /**
diff --git a/cypress/support/index.d.ts b/cypress/support/index.d.ts
index b82a049..91be0e7 100644
--- a/cypress/support/index.d.ts
+++ b/cypress/support/index.d.ts
@@ -2,6 +2,9 @@
 // load type definitions that come with Cypress module
 /// <reference types="cypress" />
 
+/**
+ * TODO: remove and use solution proposed in commands.ts instead
+ */
 declare namespace Cypress {
   interface Chainable<Subject> {
     /**