diff --git a/docs/parsers.md b/docs/parsers.md
index 03bc43ed..849fb577 100644
--- a/docs/parsers.md
+++ b/docs/parsers.md
@@ -122,6 +122,8 @@ Matches a numeric value with optional digits and leading sign. The exponent is s
 Parser<decimal> Decimal()
 ```
 
+NB: This is equivalent to `Number<decimal>()` and only exists for backward compatibility purposes.
+
 Usage:
 
 ```c#