diff --git a/docs/conf.py b/docs/conf.py
index 191955c9a..ccc2eb548 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -85,7 +85,7 @@ else:
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build', 'contracts', 'types', 'examples', 'grammar']
+exclude_patterns = ['_build', 'contracts', 'types', 'examples', 'grammar', 'ir']
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
diff --git a/docs/ir/ir-breaking-changes.rst b/docs/ir/ir-breaking-changes.rst
new file mode 100644
index 000000000..c39c63e23
--- /dev/null
+++ b/docs/ir/ir-breaking-changes.rst
@@ -0,0 +1,6 @@
+********************************
+Solidity IR-based Codegen Changes
+********************************
+
+This section highlights the main differences between the old and the IR-based codegen,
+along with the reasoning behind the changes and how to update affected code.