@@ 1,16 1,28 @@
-# DONSOL
+# Donsol
+
+This repository contains both the [6502 assembly](https://wiki.xxiivv.com/site/assembly.html) and [Uxntal assembly](https://wiki.xxiivv.com/site/uxntal.html) sources.
+
+## Build
+
+You must have the [Uxn](https://git.sr.ht/~rabbits/uxn/) assembler and emulator.
+
+```
+uxnasm src/main.tal bin/donsol.rom && uxnemu bin/donsol.rom
+```
+
+## Rules
Donsol is a solitary card game, designed by John Eternal in which you must go through the deck in sequences of 4 cards. A standard deck, jokers included, is a dungeon. Shuffle the deck and draw 4 cards, display them before you, this is a room. A room ends when all the cards are folded.
-## ♥︎ Hearts are Potions
+### ♥︎ Hearts are Potions
Potion give you health points equal to their value, up to a maximum of 21 health points. Drinking multiple potions in a row will make you sick and result in no extra healing, only the first potion's value will be gained in HP. Potions are equal to their value and face cards (J,Q,K,A) each are equal to 11.
-## ♦ Diamonds are Shields
+### ♦ Diamonds are Shields
Shields absorb the damage difference from a monster's value. Shields can only defend against monsters in descending value and if you use a shield on a monster with higher or equal value to the previous, it will break. Broken shields leave you unarmored, and taking full damage. A shield card will replace a previously folded shield card. Shields are equal to their value and face cards (J,Q,K,A) each are equal to 11.
-## ♣♠ Clubs and Spades are Monster Cards
+### ♣♠ Clubs and Spades are Monster Cards
Monster cards are equal to their value, and face cards are as follows J is 11, Q is 13, K is 15, A is 17; Jokers are both equal to 21. You may escape a room, if you have not escaped the previous one or have handled all the monsters in the current room. When escaping, the remaining cards are shuffled back into the deck.