add collapse and tab examples to guides/contributing.rst

guides/contributing.rst

@@ -251,6 +251,54 @@
 
       Note that a blank line is *required* after every ``code-block`` directive.
 
+- **Collapsible section**: To add a collapsible section, use the ``collapse`` directive:
+
+  .. code-block:: rst
+
+      .. collapse:: Details
+
+          Something small enough to escape casual notice.
+
+  .. collapse:: Details
+
+      Something small enough to escape casual notice.
+
+  .. code-block:: rst
+
+      .. collapse:: Open
+          :open:
+          This section is expected to be open by default.
+
+  .. collapse:: Open
+      :open:
+      This section is expected to be open by default.
+
+  .. code-block:: rst
+
+      .. collapse:: A long code block
+
+          .. code-block:: yaml
+
+              # Sample configuration entry
+              switch:
+                - platform: gpio
+                  name: "Relay #42"
+                  pin: GPIOXX
+
+  .. collapse:: A long code block
+
+      .. code-block:: yaml
+
+          # Sample configuration entry
+          switch:
+            - platform: gpio
+              name: "Relay #42"
+              pin: GPIOXX
+
+  .. note::
+
+      A blank line is *required* after every ``collapse`` directive.
+
 - **Images**: Use the ``figure`` directive to display an image:
 
   .. code-block:: rst