Add instructions on posting dataset metadata

Author: VeckoTheGecko

.github/ISSUE_TEMPLATE/01_feature.yml

@@ -21,6 +21,8 @@ body:
         Provide a clear and concise description of what the problem is. For example:
         - "I'm trying to simulate particle behavior with [specific physics], but Parcels doesn't support..."
         - "When working with [specific data format/kernel], I find it difficult to..."
+
+        If you would like to see Parcels work with a specific dataset, please also [follow our instructions on how to share dataset metadata](https://docs.oceanparcels.org/en/v4-dev/development/posting-issues.html).
     validations:
       required: true
   - type: textarea

.github/ISSUE_TEMPLATE/02_bug.yaml

@@ -17,7 +17,7 @@ body:
   - type: "textarea"
     attributes:
       label: "Code sample"
-      description: "If relevant, please provide a code example where this bug is shown as well as any error message. A [minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) is preffered as it makes it much easier for developers to identify the cause of the bug. This also allows them quickly determine whether the problem is with your code or with Parcels itself."
+      description: "If relevant, please provide a code example where this bug is shown as well as any error message. A [minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example) is preffered as it makes it much easier for developers to identify the cause of the bug. This also allows them quickly determine whether the problem is with your code or with Parcels itself. If you want support on a specific dataset, please [follow our instructions on how to share dataset metadata](https://docs.oceanparcels.org/en/v4-dev/development/posting-issues.html)"
       value: |
         ```python
         # Paste your code within this block

docs/development/index.md

@@ -17,6 +17,7 @@ Release Notes <https://github.com/Parcels-code/Parcels/releases>
 
 maintainer
 docsguide
+posting-issues
 ```
 
 ## Why contribute?
@@ -55,7 +56,7 @@ Exactly how to use Git and GitHub is beyond the scope of this documentation, and
 
 There are many ways that you can contribute to Parcels. You can:
 
-- Participate in discussion about Parcels, either through the [issues](https://github.com/Parcels-code/parcels/issues) or [discussions](https://github.com/Parcels-code/parcels/discussions) tab
+- Participate in discussion about Parcels, either through the [issues](https://github.com/Parcels-code/parcels/issues) or [discussions](https://github.com/Parcels-code/parcels/discussions) tab. See our guide on [posting-issues](./posting-issues.md).
 - Suggest improvements to [tutorials and how-to guides](../user_guide/index.md)
 - Suggest improvements to [documentation](../index.md)
 - Write code (fix bugs, implement features, codebase improvements, etc)

docs/development/posting-issues.md

@@ -0,0 +1,70 @@
+---
+file_format: mystnb
+kernelspec:
+  name: python3
+---
+
+# Participating in the issue tracker
+
+We love hearing from our community!
+We want to be able to support you in your workflows, and learn about how you use Parcels.
+In open source projects, getting feedback from users is hard - you posting
+issues and participating in the issue tracker is really useful for us and
+helps future development and squash bugs.
+
+Parcels provides issue templates for when posting issues.
+Following these templates provides structure and ensures that we have all the necessary information we need to help you.
+
+## "Parcels doesn't work with my input dataset"
+
+Parcels is designed to work with a large range of input datasets.
+
+When extending support for various input datasets, or trying to debug problems
+that only occur with specific datasets, having the dataset metadata is very valuable.
+
+This metadata could include information such as:
+
+- CF compliant metadata
+- descriptions about the origin of the dataset, or additional comments
+- the shapes and data types of the arrays
+
+This also allows us to see if your metadata is broken/non-compliant with standards - where we can then suggest fixes for you (and maybe we can tell the data provider!).
+Since version 4 of Parcels we rely much more on metadata to discover information about your input data.
+
+Sharing this metadata often provides enough debugging information to solve your problem, instead of having to share a whole dataset.
+
+Sharing dataset metadata is made easy in Parcels.
+
+### Step 1. Users
+
+As a user with access to your dataset, you would do:
+
+```{code-cell}
+import json
+
+import xarray as xr
+
+# defining an example dataset to illustrate
+# (you would use `xr.open_dataset(...)` instead)
+ds = xr.Dataset(attrs={"description": "my dataset"})
+
+output_file = "my_dataset.json"
+with open(output_file, "w") as f:
+    json.dump(ds.to_dict(data=False), f)  # write your dataset to a JSON excluding array data
+```
+
+Then attach the produced JSON file alongside your issue
+
+### Step 2. Maintainers and developers
+
+As developers looking to inspect the metadata, we would do:
+
+```{code-cell}
+from parcels._datasets.utils import from_xarray_dataset_dict
+
+with open(output_file) as f:
+    d = json.load(f)
+ds = from_xarray_dataset_dict(d)
+```
+
+From there we can take a look the metadata of your dataset!