diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eebeceb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# icon-associator
+## Description
+Makes creating and removing file associations easier.
+Also calls `SHChangeNotify()` to automatically update your file associations, and can even help sometimes if you have associated another program with a different file type, and the association for that isn't updating.
+
+## How To Use
+This code is made assuming you have already referenced `icon-associator.dll` in your project, and is using `System.Windows.Forms.dll` for the example.
+Also, the two examples for adding and removing file associations should not be added in the same code block, they should be separate, as the removal would negate the addition, making usage of this library useless.
+```csharp
+str_ExampleExtension = ".example";
+
+FileAssociation association = FileAssociation.CreateOpenInfo(
+ Application.ExecutablePath, str_ExampleExtension,
+ // returns "" "%1" with being the file path to your .exe
+ FileAssociation.DefaultCLI(Application.ExecutablePath)
+ );
+
+// add the association to your device registry if not already there
+if (!AssociationManager.CheckForAssociationInfo(association))
+ AssociationManager.AddAssociationInfo(association);
+
+// remove the association from your device registry if there
+if (AssociationManager.CheckForAssociationInfo(association))
+ AssociationManager.RemoveAssociationInfo(association);
+```