From 466d65ea5034e109bc661f5b621539c9aa7374fe Mon Sep 17 00:00:00 2001
From: Glen Mailer <glenjamin@gmail.com>
Date: Fri, 15 May 2015 10:12:00 +0100
Subject: [PATCH] Document boolean attributes in JSX

---
 docs/02.1-jsx-in-depth.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/02.1-jsx-in-depth.md b/docs/02.1-jsx-in-depth.md
index 64a7830d..2c3143d2 100644
--- a/docs/02.1-jsx-in-depth.md
+++ b/docs/02.1-jsx-in-depth.md
@@ -176,6 +176,20 @@ var person = React.createElement(
 );
 ```
 
+### Boolean Attributes
+
+Omitting the value of an attribute causes JSX to treat it as `true`. To pass `false` an attribute expression must be used. This often comes up when using HTML form elements, with attributes like `disabled`, `required`, `checked` and `readOnly`.
+
+```javascript
+// These two are equivalent in JSX for disabling a button
+<input type="button" disabled />;
+<input type="button" disabled={true} />;
+
+// And these two are equivalent in JSX for not disabling a button
+<input type="button" />;
+<input type="button" disabled={false} />;
+```
+
 ### Child Expressions
 
 Likewise, JavaScript expressions may be used to express children: