diff --git a/docs/index.rst b/docs/index.rst
index b60ea06da..17abf4b24 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -88,3 +88,4 @@ Contents
    bugs.rst
    contributing.rst
    frequently-asked-questions.rst
+   lll.rst
diff --git a/docs/lll.rst b/docs/lll.rst
new file mode 100644
index 000000000..d9409bf84
--- /dev/null
+++ b/docs/lll.rst
@@ -0,0 +1,14 @@
+###
+LLL
+###
+
+.. _lll:
+
+LLL is a low-level language for the EVM with an s-expressions syntax.
+
+The Solidity repository contains an LLL compiler, which shares the assembler subsystem with Solidity.
+However, apart from maintaining that it still compiles, no other improvements are made to it.
+
+.. warning::
+
+    The LLL codebase is deprecated and will be removed from the Solidity repository in the future.