Add devstats-data as a submodule (#9)

* Add devstats data as a submodule.

* Update README with info about building/data collection.

* Update download script.

Author: rossbar

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "devstats-data"]
+	path = devstats-data
+	url = https://github.com/scientific-python/devstats-data.git

README.rst

@@ -8,3 +8,43 @@ Scientific Python Development and Community Statistics
 
 A static site for collating & publicizing development and community statistics
 for Scientific Python projects.
+
+Installation
+------------
+
+```python
+python -m pip install -r requirements.txt
+```
+
+Building the site
+-----------------
+
+To get the data used in the analysis:
+
+```bash
+git submodule update --init
+```
+
+Then the site can be built with:
+
+```bash
+cd site
+make html
+```
+
+Devstats data
+-------------
+
+The data used for the officially deployed site is available at
+<https://github.com/scientific-python/devstats-data>.
+The data repository is included as a submodule in this project, so updating the
+submodule is all that is required to ensure you are using the latest data for
+the published site.
+The ``query.py`` script can be used to collect data for other projects like
+so: ``python query.py <repo_owner> <repo_name>`` where ``repo_owner`` and
+``repo_name`` are the names of the **org** and **repo** on GitHub, respectively.
+For example, to download the latest data for ``pandas``:
+
+```bash
+python query.py pandas-dev pandas
+```

devstats-data

@@ -186,22 +186,27 @@ def dump(self, outfile):
 @click.argument('repo_name')
 def main(repo_owner, repo_name):
     """Download and save issue and pr data for `repo_owner`/`repo_name`."""
+    # Make sure this works even if the submodule has not been initialized
+    import os
+    os.makedirs("devstats-data", exist_ok=True)
+    # Download issue data
     issues = GithubGrabber(
         'query_examples/issue_activity_since_date.gql',
         'issues',
         repo_owner=repo_owner,
         repo_name=repo_name,
     )
     issues.get()
-    issues.dump(f"_data/{repo_name}_issues.json")
+    issues.dump(f"devstats-data/{repo_name}_issues.json")
+    # Download PR data
     prs = GithubGrabber(
         'query_examples/pr_data_query.gql',
         'pullRequests',
         repo_owner=repo_owner,
         repo_name=repo_name,
     )
     prs.get()
-    prs.dump(f"_data/{repo_name}_prs.json")
+    prs.dump(f"devstats-data/{repo_name}_prs.json")