Updated docstrings

Author: Andyg79

pages/organisations/organisations_page.py

@@ -53,6 +53,8 @@ def go_to_bureau_page(self) -> None:
 
 
 class OrganisationSwitchPage:
+    """Organisation Switch Page locators and methods for interacting with the page."""
+
     def __init__(self, page: Page):
         self.page = page
         self.radio_selector = "input[name='organisation']"

tests/regression/organisation_regression_tests_user/test_change_organisation_regression_user.py

@@ -4,13 +4,17 @@
 from playwright.sync_api import Page
 from pages.organisations.organisations_page import OrganisationSwitchPage
 
+
 @pytest.mark.regression
 @pytest.mark.organisation_switch
 def test_user_can_switch_between_organisations(page: Page) -> None:
     """
-    Scenario:
-    User switches from Org 1 → Continue → Home → 'Select Organisation' → Org 2 → Continue → Home → Return.
-    Verifies switch success using aria role-based 'Continue' button logic.
+    Feature: Change Organisation
+    Scenario: Check that an English user with multiple organisations
+      is able to switch between them
+      Given I log in to BCSS "England" as user role "MultiOrgUser"
+      When I change organisation
+      Then I will be logged in as the alternative organisation.
     """
     # Log in as a user with multiple organisations
     UserTools.user_login(page, "Specialist Screening Practitioner at BCS009")