From ba99332b2d8a2d02fef62a594356bb622584ef0f Mon Sep 17 00:00:00 2001
From: isms <isaac.slavitt@gmail.com>
Date: Fri, 30 Oct 2015 15:47:00 -0400
Subject: [PATCH] Start to flesh out READMEs

---
 .gitattributes                         |  1 +
 README.md                              |  4 ++++
 {{ cookiecutter.repo_name }}/.pylintrc | 11 ++++++++++
 {{ cookiecutter.repo_name }}/README.md | 29 +++++++++++++++++++++++++-
 4 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 .gitattributes
 create mode 100644 {{ cookiecutter.repo_name }}/.pylintrc

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..176a458
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+* text=auto
diff --git a/README.md b/README.md
index 6670243..8400367 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,6 @@
 cookiecutter-data-science
 -------------------------
+
+To start a new project:
+
+    cookiecutter git@github.com:drivendata/cookiecutter-data-science.git
diff --git a/{{ cookiecutter.repo_name }}/.pylintrc b/{{ cookiecutter.repo_name }}/.pylintrc
new file mode 100644
index 0000000..d41dc2d
--- /dev/null
+++ b/{{ cookiecutter.repo_name }}/.pylintrc	
@@ -0,0 +1,11 @@
+[MASTER]
+load-plugins=pylint_common
+
+[FORMAT]
+max-line-length=120
+
+[MESSAGES CONTROL]
+disable=missing-docstring,invalid-name
+
+[DESIGN]
+max-parents=13
\ No newline at end of file
diff --git a/{{ cookiecutter.repo_name }}/README.md b/{{ cookiecutter.repo_name }}/README.md
index bdbfb76..da54453 100644
--- a/{{ cookiecutter.repo_name }}/README.md	
+++ b/{{ cookiecutter.repo_name }}/README.md	
@@ -1 +1,28 @@
-## {{ cookiecutter.repo_name }}
+{{cookiecutter.project_name}}
+==============================
+
+{{cookiecutter.description}}
+
+Organization
+------------
+
+    ├── data
+    │   ├── external       <- Data from third party sources.
+    │   ├── interim        <- Intermediate data that has been transformed goes.
+    │   ├── processed      <- The final, canonical data sets for modeling.
+    │   └── raw            <- The original, immutable data dump.
+    │
+    ├── notebooks          <- Jupyter or Beaker notebooks. Naming convention is a number (for ordering),
+    │                         the creator's initials, and a short `-` delimited description, e.g.
+    │                         `1.0-jqp-initial-data-exploration`.
+    ├── references         <- Reports, data dictionaries, manuals, and all other explanatory materials.
+    └── src                <- Source code. Possible subdirectories might be `scripts` or `API` for
+                              projects with larger codebases.
+
+Basic Commands
+--------------
+
+### Syncing data to S3
+
+* `make sync_data_to_s3` will use `s3cmd` to recursively sync files in `data/` up to `s3://{{ cookiecutter.s3_bucket }}/data/`.
+* `make sync_data_from_s3` will use `s3cmd` to recursively sync files from `s3://{{ cookiecutter.s3_bucket }}/data/` to `data/`.
\ No newline at end of file