diff --git a/docs/iris/src/whatsnew/contributions_v2.0.0/incompatiblechange_2017-Oct-18_rules-removal.txt b/docs/iris/src/whatsnew/contributions_v2.0.0/incompatiblechange_2017-Oct-18_rules-removal.txt
new file mode 100644
index 0000000000..9db09a91e0
--- /dev/null
+++ b/docs/iris/src/whatsnew/contributions_v2.0.0/incompatiblechange_2017-Oct-18_rules-removal.txt
@@ -0,0 +1,13 @@
+* The following classes and functions have been removed from :mod:`iris.fileformats.rules`:
+	* ```iris.fileformat.rules.calculate_forecast_period```
+	* ```iris.fileformat.rules.log```
+	* ```iris.fileformat.rules.CMAttribute```
+	* ```iris.fileformat.rules.CMCustomAttribute```
+	* ```iris.fileformat.rules.CoordAndDims```
+	* ```iris.fileformat.rules.DebugString```
+	* ```iris.fileformat.rules.FunctionRule```
+	* ```iris.fileformat.rules.ProcedureRule```
+	* ```iris.fileformat.rules.Rule```
+	* ```iris.fileformat.rules.RulesContainer```
+	* ```iris.fileformat.rules.RuleResult```
+* Removed deprecated keyword argument ```legacy_custom_rules``` from :class:`iris.fileformats.rules.Loader`.
\ No newline at end of file