Document boolean attributes

Author: trendels

docs/source/basics.rst

@@ -172,6 +172,22 @@ Attribute values are quoted (HTML-escaped) automatically:
 >>> print(div(attr='a value with "quotes" and a <tag>'))
 <div attr="a value with &quot;quotes&quot; and a &lt;tag&gt;"></div>
 
+Boolean attributes
+^^^^^^^^^^^^^^^^^^
+
+A boolean HTML attribute is one that does not have a value. For example, to
+mark an input field as required, you can write ``<input required>``. There is
+also an alternative syntax, which minihtml uses: ``<input
+required="required">``.
+
+To set a boolean attribute, pass ``True`` as the value. ``False`` is also a
+valid value, and causes the attribute to be omitted (this can be useful if you
+set the attribute from a variable):
+
+>>> from minihtml.tags import input
+>>> print(input(required=True, disabled=False))
+<input required="required">
+
 .. _content:
 
 Content