updating instructions in README

Author: Br3nda

README.md

@@ -6,9 +6,9 @@ This is a fork of a 2001-ish era PHP app from MySociety in the UK, repurposed fo
 
 OpenAustralia.org.au is a website run by the non-partisan charity, OpenAustralia Foundation, which makes Australian government and parliamentary information easily accessible to the public through tools such as searching Hansard (parliamentary debates) and tracking politicians' voting records. The site aims to increase transparency and civic engagement in Australian democracy. It provides platforms to easily follow what MPs and Senators say and do, and tracks their registers of interests.
 
- ## What is this data?
+## What is this data?
 
-Everything elected politicians say in Australia's Senate and Parliament is recorded in Australia's Official Hansard. This documentation is obtained using scapers (see https://github.com/openaustralia/openaustralia-parser/ )
+Everything elected politicians say in Australia's Senate and Parliament is recorded in Australia's Official Hansard. This documentation is obtained using scrapers (see https://github.com/openaustralia/openaustralia-parser/ )
 and displayed on openaustralia.org.au. 
 
 ## data feeds
@@ -34,13 +34,21 @@ from the repo root, which will install the version of PHP this project
 expects.
 
 If `mise install` fails while compiling PHP from source, you may be
-missing build dependencies. On Ubuntu:
+missing build dependencies.
+
+On Ubuntu:
 
 ```bash
 sudo apt update
 sudo apt install re2c bison autoconf build-essential libxml2-dev libssl-dev libcurl4-openssl-dev libpng-dev libjpeg-dev libonig-dev libzip-dev libgd-dev
 ```
 
+On macOS (with [Homebrew](https://brew.sh/)):
+
+```bash
+brew install autoconf bison re2c pkg-config libxml2 openssl@3 curl libpng jpeg oniguruma libzip gd
+```
+
 ### Bumping the PHP version
 
 The PHP version is declared in a few places. To bump it, update all of
@@ -74,11 +82,11 @@ make install           # composer install + compile scripts/run-with-lockfile
 Re-run `make dependencies` after pulling changes that touch `composer.json`
 or `composer.lock`.
 
-### Running the checks git does
+### Running the checks CI does
 
 ```bash
-make lint-ci | grep -v "No syntax errors detected in" # ignore all the "its ok" messages
-make phpcs-ci 
+make lint-php-ci | grep -v "No syntax errors detected in" # ignore all the "its ok" messages
+make phpcs-ci
 composer validate
 ```
 
@@ -160,40 +168,26 @@ git add db/migrations/<your_new_migration>.php db/schema.sql
 
 ### Running the tests
 
-Unit tests run without a database:
+`make test` runs the whole phpunit suite. Integration tests skip
+themselves automatically if no database is reachable, so you can run
+this without MySQL:
 
 ```bash
 make test
-./vendor/bin/phpunit tests/
 ```
 
-To run tests with database integration, start MySQL first:
+To include the integration tests, start MySQL first:
 
 ```bash
 make docker-run
 ```
 
-This starts both the webserver and MySQL container. Wait a few seconds for MySQL to be ready, then run:
+Wait a few seconds for MySQL to be ready, then run:
 
 ```bash
 make test-all
 ```
 
-### Running tests in Docker (simplest method)
-
-To run all tests inside Docker with automatic database setup:
-
-```bash
-make test-docker
-```
-
-This will:
-- Start the MySQL container
-- Load the database schema
-- Run all tests with database integration
-
-No need to manually start containers or set environment variables.
-
 ### Running tests with coverage
 
 To generate code coverage reports (requires Xdebug or PCOV):
@@ -241,15 +235,13 @@ docker compose down
 ### Sharing database with openaustralia-parser for development
 
 You can setup local development for both repos by:
- 
+
 ```bash
 # DO NOT DO THIS ON PRODUCTION!!!!
 cd ../twfy
 cp conf/general-example.local-dev conf/general
-
-cd ../openaustralia-parser # if not already there
-cd ../twfy
 make docker-db-migrate                # or: ./vendor/bin/phinx migrate -c phinx.php
+
 cd ../openaustralia-parser
 bundle exec rake db:fixtures:load   # for a limited set of fixtures
 bundle exec rake db:stats # to show which tables have data