diff --git a/sc2/doc/devel/meleeteams b/sc2/doc/devel/meleeteams
new file mode 100644
index 000000000..ec6ea33b7
--- /dev/null
+++ b/sc2/doc/devel/meleeteams
@@ -0,0 +1,54 @@
+This file describes the binary file format for SuperMelee teams.
+The saving and loading is handled in sc2code/loadmele.c.
+
+This file format will be replaced by a human-readable format in the future.
+
+A SuperMelee team consists of the following data:
+           struct TEAM_IMAGE {
+ 0 - 13        uint8_t ShipList[MELEE_FLEET_SIZE];
+                       /* Originally 6*2 ships, now 7*2 */
+14 - 68        char TeamName[MAX_TEAM_CHARS + 1 + 24];
+                       /* \0-terminated
+           };
+
+The file uqm.cfg contains:
+ 0 -   0   Player Control for player 1 (bottom player)
+           One of:
+              1 - Human controlled
+              6 - Computer controlled
+              8 - Network controlled (added later)
+           or'ed with one of:
+             16 - Standard computer control rating
+             32 - Good computer control rating
+             64 - Awesome computer control rating
+ 1 -  69   TEAM_IMAGE for player 1, as described above
+70 - 139   Bytes 0-69 repeated for player 2 (top player)
+
+The entries in ShipList are:
+  0 - Androsynth Guardian
+  1 - Arilou Skiff
+  2 - Chenjesu Broodhome
+  3 - Chmmr Avatar
+  4 - Druuge Mauler
+  5 - Human Earthling
+  6 - Ilwrath Avenger
+  7 - Kohr-Ah Marauder
+  8 - Melnorme Trader
+  9 - Mmrnmhrm X-Form
+ 10 - Mycon Podship
+ 11 - Orz Nemesis
+ 12 - Pkunk Fury
+ 13 - Shofixti Scout
+ 14 - Slylandro Probe
+ 15 - Spathi Eluder
+ 16 - Supox Blade
+ 17 - Syreen Penetrator
+ 18 - Thraddash Torch
+ 19 - Umgah Drone
+ 20 - Ur-Quan Dreadnought
+ 21 - Utwig Jugger
+ 22 - VUX Intruder
+ 23 - Yehat Terminator
+ 24 - Zoq Fot Pik Stinger
+255 - Unused slot
+