Document the Password widget

docs/dev/reference/widgets/password.md

@@ -1,6 +1,34 @@
 ---
 title: Password
-description: Password text field (not yet documented)
+description: Password text field.
 ---
 
-{{< widget-notice >}}
+This widget renders a `type="password"` text field, with the ability to show the otherwise obfuscated password (when
+newly entered).
+
+![Password]({{% asset "images/dev/reference/widgets/password.png" %}}?classes=shadow)
+
+## Options
+
+This widget has no special options, but all options for the [`text`]({{% relref "text" %}}) widget are also
+relevant.
+
+| Key               | Value                       |
+|-------------------|-----------------------------|---
+| `inputType`       | `password` (string)         |
+
+## Example
+
+```php
+// …
+'myPassword' => [
+    'inputType' => 'password',
+    'eval' => [
+        'mandatory' => true,
+        'minlength' => Config::get('minPasswordLength'),
+        'tl_class' => 'w50'
+    ],
+    'sql' => ['type' => 'string', 'length' => 255, 'default' => ''],
+],
+// …
+```