Fix all checks, doc8 validation, and add .gitkeep for empty directory

Signed-off-by: ziad hany <ziadhany2016@gmail.com>

Author: ziadhany

README.rst

@@ -21,22 +21,28 @@ Configuration format
 
   * last serial number processed (used in indexes at pypi, npm etc)
   * last processed commit (where the data is stored in git repos)
-  * directory to store las fetched index data (like the JSON fetched from pypi simple with package names and last updated info)
+  * directory to store las fetched index data
+    (like the JSON fetched from pypi simple with package names and last updated info)
   * state information in ``state``:
 
     * ``null``: mining has not started.
-    * ``initital-sync`` : at the start of mining we need to mine a huge amount of packages for packageURL to catch up.
-      This is typically very large and could take several hours to several days dependening on the ecosystem size.
-      We fetch and save an index state and mine all packageURLs till there. Once we reach a state where remaining
-      new packageURLs can be mined in a couple hours, we can move on to the next state where we mine new packageURLs
-      added in a periodic manner.  
-    * ``periodic-sync`` : This is a periodic update of new packageURLs added in the index in a period, and typically this
+    * ``initital-sync`` : at the start of mining we need to mine a huge
+      amount of packages for packageURL to catch up.
+      This is typically very large and could take several hours to several days
+      dependening on the ecosystem size.
+      We fetch and save an index state and mine all packageURLs till there.
+      Once we reach a state where remaining
+      new packageURLs can be mined in a couple hours, we can move on to
+      the next state where we mine new packageURLs
+      added in a periodic manner.
+    * ``periodic-sync`` : This is a periodic update of new packageURLs
+      added in the index in a period, and typically this
       should not take more than a couple hours.
 
   * optional elements to improve readability/debugging:
 
     * ``last_updated``: date and time of last checkpoint update
 
 * ``packages_checkpoints.json``: stores checkpoint related to:
-  
+
   * ``packages_mined``: which packages have been mined in the ``initital-sync`` state.