improv: document test given when then

Signed-off-by: heitorlessa <lessa@amazon.co.uk>

test/test_poetry_project.py

@@ -33,6 +33,8 @@ poetry_dummy_project.files["pyproject.toml"] = pyproject_package_file
 
 def test_poetry_package(tmp_path):
 
+    # GIVEN a project that only has pyproject.toml
+    # managed by poetry
     project_dir = tmp_path / "project"
     poetry_dummy_project.generate(project_dir)
 
@@ -42,8 +44,11 @@ def test_poetry_package(tmp_path):
     # more info: https://github.com/pyca/cryptography/issues/5101
     skip_outdated_pip_images_env = {'CIBW_SKIP': 'cp27-* *-win32 *-manylinux_i686'}
 
+    # WHEN we attempt to build wheels for multiple platforms
+    # for dummy_package package
     actual_wheels = utils.cibuildwheel_run(project_dir, add_env=skip_outdated_pip_images_env)
 
-    # check that the expected wheels are produced
+
+    # THEN we should have a dummy_package wheel with version 0.1.0
     expected_wheels = utils.expected_wheels("dummy_package", "0.1.0")
     assert set(actual_wheels) == set(expected_wheels)