diff --git a/docs/source/cell/properties.rst b/docs/source/cell/properties.rst
index 72ea7611262..e853ea50a16 100644
--- a/docs/source/cell/properties.rst
+++ b/docs/source/cell/properties.rst
@@ -1,10 +1,12 @@
 Cell properties
 ---------------
 
-.. TODO:: Fill :cell:ref:`is_evaluable`
-
 .. cell:defprop:: is_evaluable
 
+   These cells are able to be used in conjunction with the `eval` command.  Some
+   passes, such as `opt_expr`, may also be able to perform additional
+   optimizations on cells which are evaluable.
+
 .. cell:defprop:: x-aware
 
    Some passes will treat these cells as the non 'x' aware cell.  For example,