diff --git a/README.md b/README.md
index e5d0bed..44ca06b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
 
-## installation
+
+## worddiv - query LaTeX’s word division (hyphenation) dictionary ##
+
+The LaTeX typesetting software includes high quality dictionaries of word division patterns, which define the points at which a word may be broken across the end of a line.
+
+worddiv is a simple script that makes it convenient to query the LaTeX word division dictionary interactively using a terminal emulator. This can help, for example, when proofreading galleys that do not adhere to the word hyphenations presented in an approriate high quality dictionary.
+
+
+
+## installation ##
+
+## usage ##
+
+