diff --git a/README.md b/README.md
index e3c9ac9..3150311 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
 # Parsable-Instructions
-A parsable list of x86 instructions.
+List of all instructions found in Intel documentations, listed into XML files for easy parsing.
+Each instruction in the XML contains:
+
+-Instruction mnemonic.
+
+-Instruction arguments.
+
+-Instruction opcode.
+
+-Instruction opcode encoding.
+
+-Instruction 64 bit mode support.
+
+-Instruction 32 bit mode support.
+
+-Instruction CPUID flags.
+
+-Instruction operands encoding.
+
+-Instruction description.
+
+**ins_az.x86.raw.xml**: Contains all instructions found in “Intel® 64 and IA-32 Architectures Software Developer Manuals volume 2”.
+
+**ins_avx512.x86.raw.xml**: Contains all instructions found in “Intel® Architecture Instruction Set Extensions Programming Reference 319433-022”.
+
+
+