move pedestal_size_z to PlateHolder in docs

Author: rickwierenga

docs/resources/carrier/plate-carrier/plate_carrier.ipynb

@@ -234,27 +234,6 @@
    "source": [
     "await lh.move_resource(my_plate, my_plate_carrier[2])"
    ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "## Pedestal z height\n",
-    "\n",
-    "> ValueError(\"pedestal_size_z must be provided. See https://docs.pylabrobot.org/resources/plate_carriers.html#pedestal_size_z for more information.\")\n",
-    "\n",
-    "Many plate carriers feature a \"pedestal\" or \"platform\" on the sites. Plates can sit on this pedestal, or directly on the bottom of the site. This depends on the pedestal _and_ plate geometry, so it is important that we know the height of the pedestal.\n",
-    "\n",
-    "The pedestal information is not typically available in labware databases (like the VENUS or EVOware databases), and so we rely on users to measure and contribute this information.\n",
-    "\n",
-    "Here's how you measure the pedestal height:\n",
-    "\n",
-    "![Pedestal height measurement](/resources/img/pedestal/measure.jpeg)\n",
-    "\n",
-    "Once you have measured the pedestal height, you can contribute this information to the PyLabRobot Labware database. Here's a guide on contributing to the open-source project: [\"How to Open Source\"](/contributor_guide/how-to-open-source.md).\n",
-    "\n",
-    "For background, see PR 143: [https://github.com/PyLabRobot/pylabrobot/pull/143](https://github.com/PyLabRobot/pylabrobot/pull/143)."
-   ]
   }
  ],
  "metadata": {

docs/resources/index.md

@@ -129,7 +129,6 @@ container/container
 deck/deck
 itemized-resource/itemized-resource
 resource-holder/resource-holder
-resource-holder/plate-holder
 plate-adapter/plate-adapter
 resource-stack/resource-stack
 ```

docs/resources/resource-holder/plate-holder.md

@@ -0,0 +1,21 @@
+# PlateHolder
+
+TODO: write a tutorial
+
+See :class:`~pylabrobot.resources.PlateHolder` for the API reference.
+
+## Pedestal z height
+
+> ValueError("pedestal_size_z must be provided. See https://docs.pylabrobot.org/resources/resource-holder/plate-holder.html#pedestal_size_z for more information.")
+
+Many plate carriers feature a "pedestal" or "platform" on the sites. Plates can sit on this pedestal, or directly on the bottom of the site. This depends on the pedestal _and_ plate geometry, so it is important that we know the height of the pedestal.
+
+The pedestal information is not typically available in labware databases (like the VENUS or EVOware databases), and so we rely on users to measure and contribute this information.
+
+Here's how you measure the pedestal height:
+
+![Pedestal height measurement](/resources/img/pedestal/measure.jpeg)
+
+Once you have measured the pedestal height, you can contribute this information to the PyLabRobot Labware database. Here's a guide on contributing to the open-source project: ["How to Open Source"](/contributor_guide/how-to-open-source.md).
+
+For background, see PR 143: [https://github.com/PyLabRobot/pylabrobot/pull/143](https://github.com/PyLabRobot/pylabrobot/pull/143).

docs/resources/resource-holder/plate-holder.rst

@@ -14,7 +14,13 @@
     "`ResourceHolder` ensures that the child resource is placed correctly inside the\n",
     "holder. When the holder is rotated the child resource is automatically shifted\n",
     "so that its local origin lines up with the correct corner of the holder. This\n",
-    "avoids having to manually adjust coordinates for every rotation."
+    "avoids having to manually adjust coordinates for every rotation.\n",
+    "\n",
+    "For `ResourceHolder`s that hold plates, use the `PlateHolder` subclass instead.\n",
+    "\n",
+    "```{toctree}\n",
+    "plate-holder\n",
+    "```"
    ]
   },
   {