Added article for embedding excalidraw diagrams and fixed config assertion tests

Author: niamhdougan

docs/how-to.rst

@@ -10,3 +10,4 @@ Practical step-by-step guides for the more experienced user.
 
     how-to/existing
     how-to/update
+    how-to/excalidraw

docs/how-to/excalidraw.rst

@@ -0,0 +1,18 @@
+How to embed Excalidraw diagrams
+================================
+
+Start off by creating your diagram in https://excalidraw.com
+
+.. raw:: html
+    :file: ../images/excalidraw-example.svg
+
+Click 'Save as image' and make sure the 'Embed scene' checkbox is enabled. This is required for loading your image back into Excalidraw should you wish to make changes later on. Name your file and export to SVG, saving it inside ``docs/images``.
+
+Add the following to embed it inside your documentation::
+
+    .. raw:: html
+        :file: ../images/my-diagram.excalidraw.svg
+
+It is preferred to use the above convention over ``.. image::`` in order to retain the font used by Excalidraw.
+
+Rebuild the docs and open the resulting html inside a browser.

docs/images/excalidraw-example.svg

@@ -41,8 +41,8 @@ def test_new_module(tmp_path: Path):
 
     conf = ConfigParser()
     conf.read(module / "setup.cfg")
-    assert conf["metadata"]["author"] == "Firstname Lastname"
-    assert conf["metadata"]["author_email"] == "[email protected]"
+    assert conf["metadata"]["author"] == '"Firstname Lastname"'
+    assert conf["metadata"]["author_email"] == '"[email protected]"'
     versiongit_lines = [
         line
         for line in (module / "docs" / "reference" / "api.rst").read_text().splitlines()