made every cheat sheet question a citable sub-heading

Author: michaelweinold

environment.yaml

@@ -12,7 +12,7 @@ dependencies:
   - pydata-sphinx-theme=0.16.0 # website theme # https://anaconda.org/conda-forge/pydata-sphinx-theme/files
   - myst-parser=4.0.0 # Markdown support # https://anaconda.org/conda-forge/myst-parser/files
   - myst-nb=1.1.2 # Jupyter notebook support # https://anaconda.org/conda-forge/myst-nb/files
-  - sphinx-autoapi=3.3.2 # to build docs from source code instead of package import # https://anaconda.org/conda-forge/sphinx-autoapi/files
+  - sphinx-autoapi=3.3.3 # to build docs from source code instead of package import # https://anaconda.org/conda-forge/sphinx-autoapi/files
   - sphinx-design=0.6.1 # responsive web component support # https://anaconda.org/conda-forge/sphinx-design/files
   - sphinx-notfound-page=1.0.4 # custom 404 page # https://anaconda.org/conda-forge/sphinx-notfound-page/files
   - graphviz=12.0.0 # for plotting dependency diagrams with sphinx-autoapi # https://anaconda.org/conda-forge/graphviz/files

source/content/cheatsheet/databases.md

@@ -1,62 +1,64 @@
-## Databases
+# Databases 
 
-**Q:** How do I list all databases?
+## Basic Operations
+
+### How do I list all databases?
 
 ```python
 sorted(bd.databases)
 ```
 
-**Q:** How do I test if a given database is installed?
+### How do I test if a given database is installed?
 
 ```python
 '<my database label>' in bd.databases
 ```
 
-**Q:** How do I instantiate a `Database` object?
+### How do I instantiate a `Database` object?
 
 ```python
 my_db = bd.Database('<database_name>')
 ```
 
-**Q:** How do I copy a `Database`?
+### How do I copy a `Database`?
 
 ```python
 copied_database = bd.Database('<database_name>').copy('<new_name>')
 ```
 
-**Q:** How do I rename a `Database`?
+### How do I rename a `Database`?
 
 ```python
 new_database = bd.Database('<database_name>').rename('<new_name>')
 ```
 
-**Q:** How do I delete a `Database`?
+### How do I delete a `Database`?
 
 ```python
 del bd.databases['<database_name>']
 ```
 
-### Metadata
+## Metadata
 
-**Q:** How do I see the `Database` metadata?
+### How do I see the `Database` metadata?
 
 ```python
 bd.Database('<database_name>').metadata
 ```
 
-**Q:** How do I change the `Database` metadata?
+### How do I change the `Database` metadata?
 
 ```python
 bd.Database('<database_name>').metadata['<some_key>'] = '<some_value>'
 ```
 
-**Q:** How do I see which other databases this `Database` refers to?
+### How do I see which other databases this `Database` refers to?
 
 ```python
 bd.Database('<database_name>').metadata['depends']
 ```
 
-**Q:** How can I see what kind of modelling paradigm and storage engine a `Database` uses?
+### How can I see what kind of modelling paradigm and storage engine a `Database` uses?
 
 This information is given to a limited degree by the database backend:
 
@@ -70,19 +72,19 @@ There are three backends in a normal Brightway installation:
 * `iotable`: Uses the SQLite database for nodes, but stores edges only in datapackages. Limits edges to a single numerical value without uncertainty, but gives better performance for large IO data.
 * `multifunctional`: Stores `multifunctional` processes as a custom node type, and automatically allocates following the given database or process preferences when creating datapackages.
 
-### Searching
+## Searching
 
-**Q:** How do I search a `Database`?
+### How do I search a `Database`?
 
 ```python
 bd.Database('<database_name>').search('<my_query_string>')
 ```
 
 See {py:obj}`bw2data.backends.base.SQLiteBackend.search` for documentation and function options.
 
-### Datapackages
+## Datapackages
 
-**Q:** How do I get the `bw_processing` datapackage for this `Database`?
+### How do I get the `bw_processing` datapackage for this `Database`?
 
 ```python
 bd.Database('<database_name>').datapackage()

source/content/cheatsheet/exporting.md

@@ -1,6 +1,8 @@
 # Exporting Data or Projects
 
-**Q:** How do I share share my entire project with someone else?
+## Basic Operations
+
+### How do I share share my entire project with someone else?
 
 ```python
 bi.backup.backup_project_directory(project="<my_project>", dir_backup="<target_directory>")

source/content/cheatsheet/ia.md

@@ -1,26 +1,26 @@
-## Impact Assessment
+# Impact Assessment
 
-### Impact Categories (`Method`)
+## Impact Categories (`Method`)
 
-**Q:** How do I list the installed impact categories?
+### How do I list the installed impact categories?
 
 ```python
 sorted(bd.methods)
 ```
 
-**Q:** How do I test if a given impact category is installed?
+### How do I test if a given impact category is installed?
 
 ```python
 ('<impact>', '<category>') in bd.methods
 ```
 
-**Q:** How can I get a random impact category?
+### How can I get a random impact category?
 
 ```python
 bd.methods.random()
 ```
 
-**Q:** How do I search for an impact category using list comprehensions?
+### How do I search for an impact category using list comprehensions?
 
 ```python
 [
@@ -31,27 +31,27 @@ bd.methods.random()
 ```
 
 (iterate-lcia-method)=
-**Q:** How do I see the data in a given impact category?
+### How do I see the data in a given impact category?
 
 ```python
 my_method_object = bd.Method(('<impact>', '<category>'))
 list(my_method_object)
 ```
 
 (lcia-tuple-structure)=
-**Q:** How is the data in impact categories structured?
+### How is the data in impact categories structured?
 
 Iterating over a `Method` object yields tuples.
 
 * The first element in the tuple will be the biosphere `Node`
 * The second element will be the characterization factor, either as a number, or as a dictionary which includes uncertainty information
 * There could be a third element, which gives the *location* for the characterization factor. This third element is not required.
 
-**Q:** How do I interpret the uncertainty dictionary?
+### How do I interpret the uncertainty dictionary?
 
 See the [`stats_arrays` documentation](https://stats-arrays.readthedocs.io/en/latest/#mapping-parameter-array-columns-to-uncertainty-distributions).
 
-**Q:** How do I create a new impact category?
+### How do I create a new impact category?
 
 Start by defining characterization data following the tuple format defined in `How is the data in impact categories structured?`:
 
@@ -75,13 +75,13 @@ Then write the characterization factor to the `Method`:
 bd.Method(('<impact>', '<category>')).write(my_cf_data)
 ```
 
-**Q:** How do I see the impact category metadata?
+### How do I see the impact category metadata?
 
 ```python
 bd.Method(('<impact>', '<category>')).metadata
 ```
 
-**Q:** How do I change the impact category metadata?
+### How do I change the impact category metadata?
 
 ```python
 bd.Method(('<impact>', '<category>')).metadata['<some_key>'] = '<some_value>'