docs: add contributing new resources guide (#576)

Author: rickwierenga

docs/contributor_guide/contributing-new-resources.md

@@ -0,0 +1,60 @@
+# Contributing new resources
+
+PyLabRobot ships with a growing library of resource definitions for common labware.
+If you define a new resource it helps the community when you contribute it back.
+This page describes the information to include and how to format it.
+
+## 1. Update the resource library
+
+Add an entry for your resource under the appropriate manufacturer page in
+{doc}`the resource library </resources/index>`.
+List the part number, name, a picture and a link to the manufacturer's website.
+Existing entries use a table format like this:
+
+```
+| Description | Image | PLR definition |
+|-------------|-------|----------------|
+| 'VWRReagentReservoirs25mL'<br>Part no.: 89094<br>[manufacturer website](https://us.vwr.com/store/product/4694822/vwr-disposable-pipetting-reservoirs)<br>Polystyrene Reservoirs | ![](img/vwr/VWRReagentReservoirs25mL.jpg) | `VWRReagentReservoirs25mL` |
+```
+
+Use the same style and folder structure for images.
+
+## 2. Document attribute sources
+
+When writing a resource definition annotate each attribute with its origin.
+Link any technical drawings you consulted using an archived copy for
+permanence and mark those values with `# from spec`.
+If you measured a value yourself append `# measured`.
+
+````python
+# example
+
+def AGenBio_96_wellplate_Ub_2200ul(name: str, lid: Optional[Lid] = None) -> Plate:
+    """
+    AGenBio Catalog No. P-2.2-SQG-96
+    - Material: Polypropylene
+    - Max. volume: 2200 uL
+    """
+    INNER_WELL_WIDTH = 8  # measured
+    INNER_WELL_LENGTH = 8  # measured
+
+    well_kwargs = {
+        "size_x": INNER_WELL_WIDTH,  # measured
+        ...
+    }
+
+    return Plate(
+        name=name,
+        size_x=127.76,  # from spec
+        size_y=85.48,  # from spec
+        size_z=42.5,   # from spec
+        ...
+    )
+````
+
+## 3. Add imports
+
+If you place your resource in a new module, remember to import it from the
+package's `__init__.py` so users can load it directly.
+
+Thank you for helping expand the resource library!

docs/contributor_guide/index.md

@@ -4,6 +4,7 @@
 :maxdepth: 2
 
 contributing
+contributing-new-resources
 how-to-open-source
 ```