Update README.md

Author: Miltos

README.md

@@ -1,19 +1,18 @@
-Near-Duplicate Code Detector
-===
+# Near-Duplicate Code Detector
 
-This cross-platform sample tool detects exact and near duplicates of code maintained by MSRC. It has been created for the purpose of deduplicating code corpora for research purposes.
+This cross-platform sample tool detects exact and near duplicates of code maintained by the [Deep Program Understanding](https://www.microsoft.com/en-us/research/project/program/) group in Microsoft Research, Cambridge, UK. It has been created for the purpose of deduplicating code corpora for research purposes.
 
 *Requirements*: .NET Core 2.1 or higher. For parsing code, an appropriate runtime for each of the languages that needs to be tokenized is also required.
 
 To run the near-duplicate detection run:
 ```
-dotnet run /path/to/DuplicateCodeDetector.csproj detect path/to/dataFolder outputFile
+$ dotnet run /path/to/DuplicateCodeDetector.csproj detect path/to/dataFolder outputFile
 ```
 This will use all the `.jsonl.gz` files in the `dataFolder` and output an `outputFile` with the duplicate pairs and an `outputFile.json` with the groups of detected duplicates.
 
 ### Input Data
 
-The input data should be one or more `.jsonl.gz` files. These are compressed files where each line has a single JSON entry of the form
+The input data should be one or more `.jsonl.gz` files. These are compressed [JSONL](http://jsonlines.org/) files where each line has a single JSON entry of the form
 ```
 {
     "filename": "unique identifier of file, such as a path or a unique id",
@@ -22,7 +21,7 @@ The input data should be one or more `.jsonl.gz` files. These are compressed fil
 ```
 
 The `tokenizers` folder in this repository contains tokenizers for 
-C\#, Java, JavaScript and Python. Feel free to contribute tokenizers for other languages too.
+C\#, Java, JavaScript and Python. Please, feel free to contribute tokenizers for other languages too.
 
 # Contributing