docs: Add a "Try it out" page

Author: pawamoy

docs/try_it_out.md

@@ -0,0 +1,26 @@
+# Try Griffe in your browser
+
+Try Griffe directly in your browser thanks to Pyodide!
+You can click the "Run" button in the top-right corner of each editor,
+or hit ++ctrl+enter++ to run the code.
+
+
+In the following example, we import `griffe` and use it to load itself.
+Then we output the signature of the `Function` class as JSON.
+
+```pyodide install="griffe"
+import griffe
+griffe_pkg = griffe.load("griffe")
+griffe_pkg["dataclasses.Function"].as_json(indent=2)
+```
+
+Try it out with another package of your choice!
+Just replace `your-dist-name` with a package's distribution name,
+and `your_package_name` with the package's import name:
+
+```pyodide
+import micropip
+await micropip.install("your-dist-name")
+data = griffe.load("your_package_name")
+data.as_json(indent=2)[:1000]  # truncate to a thousand characters...
+```

mkdocs.yml

@@ -23,6 +23,8 @@ nav:
   - Docstrings:
     - Supported styles: docstrings.md
     - Parsing docstrings in Python: parsing_docstrings.md
+  - Try it out!:
+    - Run Griffe in your browser: try_it_out.md
 # defer to gen-files + literate-nav
 - API reference:
   - Griffe: reference/
@@ -85,6 +87,7 @@ markdown_extensions:
 - pymdownx.emoji:
     emoji_index: !!python/name:materialx.emoji.twemoji
     emoji_generator: !!python/name:materialx.emoji.to_svg
+- pymdownx.keys
 - pymdownx.magiclink
 - pymdownx.snippets:
     check_paths: true