add to docs

Author: tlambert03

docs/widgets/index.md

@@ -33,3 +33,4 @@ The following are QWidget subclasses:
 | Widget                          | Description           |
 | -----------                     | --------------------- |
 | [`QCollapsible`](./qcollapsible.md)              | A collapsible widget to hide and unhide child widgets. |
+| [`QFlowLayout`](./qflowlayout.md)                | A layout that rearranges items based on parent width. |

docs/widgets/qflowlayout.md

@@ -0,0 +1,29 @@
+# QFlowLayout
+
+QLayout that rearranges items based on parent width.
+
+```python
+from qtpy.QtWidgets import QApplication, QPushButton, QWidget
+
+from superqt import QFlowLayout
+
+app = QApplication([])
+
+wdg = QWidget()
+
+layout = QFlowLayout(wdg)
+layout.addWidget(QPushButton("Short"))
+layout.addWidget(QPushButton("Longer"))
+layout.addWidget(QPushButton("Different text"))
+layout.addWidget(QPushButton("More text"))
+layout.addWidget(QPushButton("Even longer button text"))
+
+wdg.setWindowTitle("Flow Layout")
+wdg.show()
+
+app.exec()
+```
+
+{{ show_widget(350) }}
+
+{{ show_members('superqt.QFlowLayout') }}

src/superqt/utils/_flow_layout.py

@@ -10,11 +10,11 @@ class QFlowLayout(QLayout):
     The widget placement changes depending on the width of the application window.
 
     Code translated from C++ at:
-    https://code.qt.io/cgit/qt/qtbase.git/tree/examples/widgets/layouts/flowlayout?h=6.8
+    <https://code.qt.io/cgit/qt/qtbase.git/tree/examples/widgets/layouts/flowlayout>
 
-    described at: https://doc.qt.io/qt-6/qtwidgets-layouts-flowlayout-example.html
+    described at: <https://doc.qt.io/qt-6/qtwidgets-layouts-flowlayout-example.html>
 
-    See also: https://doc.qt.io/qt-6/layout.html
+    See also: <https://doc.qt.io/qt-6/layout.html>
 
     Parameters
     ----------