Merge branch 'master' of https://githacks.org/llo/stage-one

README.md

@@ -1,3 +1,17 @@
-# stage-one
+# S1 - Native File Format Deconstruction
 
-this is a draft showing how stage one might be implimented using c++ inheritance. please refer to main.cpp for more details.
+Stage One, or "S1" for short is the first stage in LLO. This stage deconstructs native files and creates an IL version of them called "Low Level Obfuscation Intermediate File Format" or LLOIFF for short. This branch of the repository is mearly a proposal for the composition of S1 and is entirely subject to change. 
+
+### File Format Deconstructors - dctors
+
+The term "dctor" typically refered to class deconstructors, however the usage in this proposal refers to file format deconstruction. I went with the "strategy pattern" with my file format deconstruction as it seems like the best code pattern to use.
+
+*"In computer programming, the strategy pattern is a behavioral software design pattern that enables selecting an algorithm at runtime. Instead of implementing a single algorithm directly, code receives run-time instructions as to which in a family of algorithms to use."*
+
+This is ideal for deconstruction algorithms as there can be different files to deconstruct and thus different algorithms must run. For example, a COFF, PE, ELF, and LIB file all require different deconstruction algorithms. LIB in particular as it is composed of multiple COFF files. I have used "decorator pattern" for my LIB file dctor. 
+
+*"In object-oriented programming, the decorator pattern is a design pattern that allows behavior to be added to an individual object, dynamically, without affecting the behavior of other objects from the same class."*
+
+Below is a UML diagram showing how dctor's are correlated to one another.
+
+![](https://imgur.com/vtCxRIG.png)