Checking in updated README file

Author: Roturgo

README.md

@@ -1,2 +1,24 @@
 # mandelbrot-scripts
 Mandelbrot checksum scripts for benchmarking Python 3.14's free-threaded interpreter
+
+**Background:**
+These scripts implement a CPU-intensive workload for calculating a checksum for a [Mandelbrot set](https://en.wikipedia.org/wiki/Mandelbrot_set).
+
+**Purpose:**
+These scripts were used to benchmark Python 3.14's new free-threaded interpreter against the classic GIL-enabled build for a CPU-bound workload.
+
+**Files:**
+Several versions of the benchmarking scripts were created to test out a sequential implementation, a multi-processing implementation, and a threaded implementation. A Bash driver script to automate testing and CPU cooldown cycles is also provided. 
+
+The respective files are:
+* **mandelbrot_baseline.py** --> sequential implementation
+* **mandelbrot_multiprocessing.py** --> an implementation using Python's standard multiprocessing library
+* **mandelbrot_threading.py** --> an implementation using Python's standard threading library
+* **run_tests.sh** --> a Bash script to automate testing of each Python script against the GIL-enabled Python 3.14 interpreter as well as the free-threaded Python 3.14 interpreter
+
+**Running the Code:**
+1. Ensure that your test system has [uv installed](https://docs.astral.sh/uv/getting-started/installation/)
+2. Clone this repo:
+``` bash
+git clone https://github.com/Roturgo/mandelbrot-scripts.git
+```