diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cfff460
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# Julia Sample Code
+
+Sample txt files are located in the tests directory.
+
+Included are a number of implementations of the word frequency functionality (wff) in Julia using dictionaries and user-defined types.
+
+An additional implementation which uses user defined modules is also provided.
+
+## Dictionaries
+### wff_dict_verbose.jl
+
+Verbose implementation of wff using dictionaries.
+
+### wff_dict.jl
+
+Implementation of wff using dictionaries with compact code.
+
+## Types
+### wff_types_verbose.jl
+
+Verbose implementation of wff using types
+
+### wff_types.jl
+
+Implementation of wff using types with compact code.
+
+## Modules
+### modules/wff.jl
+
+A module which provides functions necessary for implementing wff.