Fix code blocks (md → rst)

Author: zyzzyxdonta

docs/reference-implementation/library.rst

@@ -7,18 +7,19 @@ Library
 
 The reference implementation can also be used as a Python library for integration into
 other tools.
-E.g., to "parameterize" a graph which contains `sc:Parameter` objects, you can use the
+E.g., to "parameterize" a graph which contains ``sc:Parameter`` objects, you can use the
 following snippet:
 
-```python
-from rdflib import Graph
-from software_card_policies.data_model import parameterize_graph
+.. code:: python
+   :caption: Graph parameterization using the library.
 
-policy_graph = Graph()  # the graph containing policies with parameter placeholders
-config_parameters = {}  # the values to override the placeholders
+   from rdflib import Graph
+   from software_card_policies.data_model import parameterize_graph
 
-parameterized_graph = parameterize_graph(policy_graph, config_parameters)
-```
+   policy_graph = Graph()  # the graph containing policies with parameter placeholders
+   config_parameters = {}  # the values to override the placeholders
+
+   parameterized_graph = parameterize_graph(policy_graph, config_parameters)
 
 The full validator implementation based on the library can be found in
 ``software_card_policies.__main__``.

docs/reference-implementation/validator.rst

@@ -8,15 +8,14 @@ Validator
 The validator can be run using the ``software-card-validate`` command which is
 equivalent to ``python -m software_card_policies``.
 
-Basic usage:
+.. code:: bash
+   :caption: Basic usage.
 
-```bash
-software-card-validate --config config.toml metadata.ttl
-```
+   software-card-validate --config config.toml metadata.ttl
 
-This will:
+This example will:
 
-1. Load policies specified in `config.toml`
+1. Load policies specified in ``config.toml``
 2. Resolve any parameters from the configuration
-3. Validate the metadata in `metadata.ttl` using the given policies
+3. Validate the metadata in ``metadata.ttl`` using the given policies
 4. Print a validation report