diff --git a/README.md b/README.md
index 954e909..19e5732 100644
--- a/README.md
+++ b/README.md
@@ -1,35 +1,14 @@
-This is the provided git repository for the WACC compilers lab. You should work
-in this repository regularly committing and pushing your work back to GitLab.
+# Wacc Compiler
 
-# Provided files/directories
+A compiler for the Wacc language built in Scala, supporting lexical analysis, parsing, semantic analysis, and AArch64 assembly code generation.
 
-## src/main
+## Pipeline
 
-The src/main directory is where you code for your compiler should go, and just
-contains a stub hello world file with a simple calculator inside.
+The Wacc compiler uses the Parsley library to parse the source file into an abstract syntax tree (AST). It then performs semantic analysis in two stages: variable renaming for scope resolution, followed by type checking. In the backend, the AST is translated into an intermediate representation (IR) designed for control-flow and optimisation. Finally, the optimised IR is converted into AArch64 assembly instructions, which are written to an output file ready for compilation and execution.
 
-## src/test
-The src/test directory is where you should put the code for your tests, which
-can be ran via `scala-cli test .`. The suggested framework is `scalatest`, the dependency
-for which has already been included.
+## Additional Features
 
-## project.scala
-The `project.scala` is the definition of your project's build requirements. By default,
-this skeleton has added the latest stable versions of both `scalatest` and `parsley`
-to the build: you should check **regularly** to see if your `parsley` needs updating
-during the course of WACC!
-
-## compile
-
-The compile script can be edited to change the frontend interface to your WACC
-compiler. You are free to change the language used in this script, but do not
-change its name.
-
-## Makefile
-
-Your Makefile should be edited so that running 'make' in the root directory
-builds your WACC compiler. Currently running 'make' will call
-`scala --power package . --server=false --jvm system --graalvm-jvm-id graalvm-java21 --native-image --force -o wacc-compiler`, producing a file called
-`wacc-compiler`
-in the root directory of the project. If this doesn't work for whatever reason, there are a few
-different alternatives you can try in the makefile. **Do not use the makefile as you're working, it's for labts/CI!**
+- **If Expressions**: Supports embedding conditional expressions within larger expressions.
+- **Parallel Imports**: Optimises compilation by handling multiple imports in parallel.
+- **Function Overloading**: Allows functions with different parameter types to share names.
+- **Peephole Optimiser**: Removes redundant instruction pairs and simplifies moves.