From b7cc2953b727f2dd952fe6ffa9736f1b230bc4c2 Mon Sep 17 00:00:00 2001
From: Amit Lavon <fluhus@users.noreply.github.com>
Date: Wed, 5 Apr 2017 14:02:06 +0300
Subject: [PATCH] Update README.md

---
 README.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index b9788d2..b17d407 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,17 @@
 WordNet in JSON Format
 ======================
 
-Such fun!
+The [WordNet](http://wordnet.princeton.edu) dataset is provided in a non-standard format that requires each user to write his/her own parsing routines. [JSON](https://en.wikipedia.org/wiki/JSON#Example) is a univeral data format, that is supported across various programming languages.
+
+**Using JSON, anyone can import and use WordNet dataset with ease.**
+
+Citation
+--------
+
+This dataset is based on: Princeton University "About WordNet." WordNet.
+Princeton University. 2010. http://wordnet.princeton.edu
+
+Please cite them if you use this dataset.
 
 Download
 --------
@@ -74,14 +84,12 @@ Go API
 
 If you are working with Go, I encourage you to skip this JSON file and work
 directly with the [Go API](https://godoc.org/github.com/fluhus/gostuff/nlp/wordnet).
-This JSON dump is simply a serialized
+This JSON dump is simply a marshaled
 [WordNet](https://godoc.org/github.com/fluhus/gostuff/nlp/wordnet#WordNet)
 struct.
 
-Citation
---------
+Having Trouble?
+---------------
 
-This dataset is based on: Princeton University "About WordNet." WordNet.
-Princeton University. 2010. http://wordnet.princeton.edu
-
-Please cite them if you use this dataset.
+If you have any issues, questions, or comments - feel free to share them on the
+[issues](https://github.com/fluhus/wordnet-to-json/issues) section.