Update readme

Author: kristiker

README.md

@@ -1,39 +1,46 @@
-Datamodel.NET is a CLR library which implements the Datamodel structure and Datamodel Exchange file format.
+Datamodel.NET is a library which implements the Datamodel structure and Datamodel Exchange (DMX) file format.
 
-Datamodel is a strongly-typed generic data structure designed by Valve Corporation for use in their games. Datamodel Exchange is a Datamodel container file format with multiple possible encodings; binary and ASCII ("keyvalues2") are included.
+Datamodel is a strongly-typed generic data structure designed by Valve Corporation. It is primarily used as a developer storage format for meshes, animations, and maps.  
 
-## Datamodel Attributes
+## Usage
+```shell
+dotnet add package KeyValues2
+```
 
-The following CLR types are supported as Datamodel attributes:
+```cs
+using var Datamodel;
 
-* `int`
-* `float`
-* `bool`
-* `string`
-* `byte`
-* `byte[]`
-* `ulong`
-* `System.TimeSpan`
+// Load a file with unknown layout
+var dm = Datamodel.Load("my_file.dmx");
+var element = dm.Root;
+var value = element.Get<string>("my_property");
 
-Additionally, the following Datamodel.NET types are supported:
+// Load a file with a known layout
+var map = Datamodel.Load<CMapRootElement>("fy_pool.vmap");
+var root = (CMapRootElement)map.Root;
+Debug.Assert(root.IsPrefab == false);
 
-* `Element` (a named collection of attributes)
-* `Vector2`
-* `Vector3` / `QAngle`
-* `Vector4` / `Quaternion`
-* `Matrix` (4x4)
-
-`IList<T>` collections of the above types are also supported. (This can be a bit confusing given that both `byte` and `byte[]` are valid attribute types; use the `ByteArray` type if you run into trouble.)
+// Layout definition
+// Full implementation can be found here:
+/// https://github.com/ValveResourceFormat/Datamodel.NET/blob/master/Tests/ValveMap.cs
+[LowercaseProperties]
+class CMapRootElement : Element
+{
+    public bool IsPrefab { get; set; }
+    public int EditorBuild { get; set; } = 8600;
+    public int EditorVersion { get; set; } = 400;
+}
+```
 
-## Datamodel.NET features
+## Features
 
 * Support for all known versions of Valve's `binary` and `keyvalues2` DMX encodings
 * Inline documentation
 * Binary codec supports just-in-time attribute loading
 * Write your own codecs with the `ICodec` interface
 * Serialize and deserialize support for Datamodel.Element subclasses
 
-## Quick example
+## Serialization
 
 ```c#
 var HelloWorld = new Datamodel.Datamodel("helloworld", 1); // must provide a format name (can be anything) and version
@@ -52,3 +59,27 @@ HelloWorld.Save("hello world.dmx", "keyvalues2", 1); // must provide an encoding
     "Hello" "string" "World"
 }
 ```
+
+## Datamodel Attributes
+
+The following CLR types are supported as Datamodel attributes:
+
+* `int`
+* `float`
+* `bool`
+* `string`
+* `byte`
+* `byte[]`
+* `ulong`
+* `System.TimeSpan`
+
+Additionally, the following Datamodel.NET types are supported:
+
+* `Element` (a named collection of attributes)
+* `Vector2`
+* `Vector3` / `QAngle`
+* `Vector4` / `Quaternion`
+* `Matrix` (4x4)
+
+`IList<T>` collections of the above types are also supported. (This can be a bit confusing given that both `byte` and `byte[]` are valid attribute types; use the `ByteArray` type if you run into trouble.)
+