diff --git a/doc/index.rst b/doc/index.rst
index fd9cac6c..3c25815b 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -134,6 +134,7 @@ Documentation
 
 * :doc:`overnight`
 * :doc:`myopic`
+* :doc:`perfect`
 
 .. toctree::
    :hidden:
diff --git a/doc/perfect.rst b/doc/perfect.rst
new file mode 100644
index 00000000..d7ca9cc0
--- /dev/null
+++ b/doc/perfect.rst
@@ -0,0 +1,9 @@
+.. _perfect:
+
+##########################################
+Perfect foresight scenarios
+##########################################
+
+Perfect foresight is currently under development but it is not yet implemented.
+
+For this, use ``foresight : 'perfect'`` in ``config.yaml``.