Update readme

README.md

@@ -1,33 +1,28 @@
 # Sly Cooper and the Thievius Raccoonus
 
-<!-- shields.io badges -->
-<!--[![Build status][build-badge]][build-url]--> <!--[![AppVeyor tests][tests-badge]][tests-url]-->
-[![Discord Channel][discord-badge]][discord-url] [![Contributors][contributors-badge]][contributors-url] [![Docs][docs-badge]][docs-url] [![Wiki][wiki-badge]][wiki-url]
+<!-- Build status shield -->
+[build-url]:https://github.com/TheOnlyZac/sly1/actions/workflows/build.yml
+[build-badge]: https://img.shields.io/github/actions/workflow/status/theonlyzac/sly1/build.yml?branch=main&label=build
 
-<!-- Build status badge -->
-[build-url]: https://ci.appveyor.com/project/TheOnlyZac/sly1/branch/main
-[build-badge]: https://ci.appveyor.com/api/projects/status/800esepa77ctpv5p/branch/main?svg=true
-
-<!-- Test status badge -->
-[tests-url]: https://ci.appveyor.com/project/TheOnlyZac/sly1/branch/main/tests
-[tests-badge]: https://img.shields.io/appveyor/tests/theonlyzac/sly1/main
-
-<!-- Contributors badge -->
+<!-- Contributors shield -->
 [contributors-url]: https://github.com/theonlyzac/sly1/graphs/contributors
 [contributors-badge]: https://img.shields.io/github/contributors/theonlyzac/sly1?color=%23db6d28
 
-<!-- Discord badge -->
+<!-- Discord shield -->
 [discord-url]: https://discord.gg/2GSXcEzPJA
 [discord-badge]: https://img.shields.io/discord/439454661100175380?color=%235865F2&logo=discord&logoColor=%23FFFFFF
 
-<!-- Docs badge -->
+<!-- Docs shield -->
 [docs-url]: https://theonlyzac.github.io/sly1
 [docs-badge]: https://img.shields.io/badge/docs-doxygen-2C4AA8
 
-<!-- Wiki badge -->
+<!-- Wiki shield -->
 [wiki-url]: https://slymods.info
 [wiki-badge]: https://img.shields.io/badge/wiki-slymods.info-2C4AA8
 
+<!-- Shields -->
+[![Build][build-badge]][build-url] [![Contributors][contributors-badge]][contributors-url] [![Discord Channel][discord-badge]][discord-url] [![Docs][docs-badge]][docs-url] [![Wiki][wiki-badge]][wiki-url]
+
 [<img src="logo.png" style="margin:7px" align="right" width="33%" alt="Sly 1 Decompilation Logo by Cooper941">][docs-url]
 
 This is a work-in-progress decompilation of [*Sly Cooper and the Thievius Raccoonus*](https://en.wikipedia.org/wiki/Sly_Cooper_and_the_Thievius_Raccoonus) for the PlayStation 2. It builds the NTSC-U version of the game, `SCUS_971.98` (SHA1: `57dc305d`).
@@ -64,8 +59,16 @@ The `scripts` directory contains scripts for setting up the build environment on
 
 #### Linux/WSL
 
-**Prerequisites**: `git`, `wine-stable`, `binutils-mips-linux-gnu`
+**Prerequisites**: `git`, `wine-32`, `binutils-mips-linux-gnu`
+
+Setup wine:
+```bash
+sudo dpkg --add-architecture i386
+sudo apt-get update
+sudo apt-get install wine32
+```
 
+Setup build environment:
 ```bash
 cd scripts
 ./setup-progd-linux.sh
@@ -156,23 +159,23 @@ When you build the executable, the following directories will be created:
 
 #### What is a decompilation?
 
-When the developers created the game, they wrote programming code that we call the source code, and compiled that into an exectuable which can run on the PS2. Our job is to reverse-engineer the compiled code and produce new, original code that behaves the same way. This process leaves us with code that is very similar (but not identical) to the source code and helps us understand what the programmers were thinking when they made the game.
+When the developers created the game, they wrote source code and compiled it to assembly code that can run on the PS2. A decompilation involves reverse-engineering the assembly code to produce new, original code that compiles to matching assembly. This process leaves us with source code that is similar to and behaves the same as the source code (though not necessarily identical), which helps us understand what the programmers were thinking when they made the game.
 
 #### How does it work?
 
-We use a tool called [Ghidra](https://ghidra-sre.org/) which was created by the [NSA](https://www.nsa.gov/) for reverse-engineering software. Ghidra analyzes the game binary to identity functions, variables, data types and structures. We then reimplement each individual function by writing C++ code that produces the same output. We do not copy/paste any code or include any original assembly code from the game binary in the decompilation.
+We use a tool called [Splat](https://github.com/ethteck/splat/) to split the binary into assembly files representing each individual function. We then reimplement every function and data structure by writing C++ code that compiles to the same assembly code. We do not include any data or code from the original game binary in the decompilation.
 
 #### Has this ever been done before?
 
-This is one the first ever PS2 decompilations. We draw inspiration from other decomp projects such as the [Super Mario 64 decomp](https://github.com/n64decomp/sm64) for the N64 and the [Breath of the Wild decomp](https://github.com/zeldaret/botw) for the Wii U (the latter being more similar in scope to this project). There is a Jak & Daxter decomp/PC port called [OpenGOAL](https://github.com/open-goal/jak-project), though that game is written in 98% GOAL language rather than C/C++.
+This was one the first ever PS2 decompilations; Several other PS2 decompilations have been started since we began in 2020. Our main inspiration was other projects such as the [Super Mario 64 decomp](https://github.com/n64decomp/sm64) for the N64 and the [Breath of the Wild decomp](https://github.com/zeldaret/botw) for the Wii U (the latter being more similar in scope to this project). There is also a Jak & Daxter decomp/PC port called [OpenGOAL](https://github.com/open-goal/jak-project), though that game is 98% GOAL language rather than C/C++.
 
 #### Is this a matching decomp?
 
-This was the first PS2 decompilation project that aimed to target the PS2 and utilize function matching. The ultimate goal is to match as many functions as possible.
+Yes. This was the first PS2 decompilation project that aimed to target the PS2 and utilize function matching, before it was even possible to produce a byte-matching executable. The ultimate goal is to match 100% of the game's functions.
 
 #### How can I help?
 
-If you want to contribute, read through [CONTRIBUTING.md](/docs/CONTRIBUTING.md) and feel free to [join our discord server](https://discord.gg/gh5xwfj) if you have any questions!
+If you want to contribute, check out [CONTRIBUTING.md](/docs/CONTRIBUTING.md) and feel free to [join our discord server](https://discord.gg/gh5xwfj) if you have any questions!
 
 
 ## Star History