Final cleanup in repo (#1)

* script for content generation

* add quickstart section

* add info to script

* fix heading

* Add available data to README

* new instruction[1]

* new instruction[2]

* remove hardcoded magic const

* Fixed examples, update data tables, rework user instruction.

* fix

* modify example, highlight gensim-data

* add \n to generator last line

* basename -> abspath

* add example with return_path=True

* add bold

* fix indentation

* remove abspath

* fix example

* simple workaround for manual testing

* fix for \n[GCC]

* README fixes

* add license, issue instructions

* logger.exception for exceptions + report in the end

* add info about storing data

CONTRIBUTING.md

@@ -0,0 +1,11 @@
+For reporting bugs, please see [contribution-guide.org](http://www.contribution-guide.org/). Be as concrete as possible, include relevant logs, package versions etc.
+
+For adding a new data set (corpus or model):
+
+1. Share a compressed file with your data set on any file-sharing service.
+
+2. Post the link here.
+
+3. Add a **detailed description** on how you created the dataset, related papers or research, plus how users should use it. Include a code example where relevant.
+
+Thanks!