From 173a18ac88bc2a545607341b7c70f6f21b9bcf1a Mon Sep 17 00:00:00 2001 From: Peter Bull Date: Sat, 19 Mar 2016 16:32:33 -0400 Subject: [PATCH] README updates --- README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/README.md b/README.md index 8400367..c784810 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,23 @@ cookiecutter-data-science ------------------------- +An opinionated, but not-afraid-to-be-wrong project template for data science projects. Pull requests welcome. Debate encouraged. + + +Requirements to create project: +----------- + - Python 2.7 or 3.5 + - [cookiecutter Python package](http://cookiecutter.readthedocs.org/en/latest/installation.html) + + To start a new project: +------------ cookiecutter git@github.com:drivendata/cookiecutter-data-science.git + + +Data +---------- +** By default, the `data` folder is included in the `.gitignore` file.** If you have a small amount of data that rarely changes, you may want to include the data in the repository. Github currently warns if files are over 50MB and rejects files over 100MB. Some other options for storing large data include [AWS S3](https://aws.amazon.com/s3/) with a syncing tool (e.g., [`s3cmd`](http://s3tools.org/s3cmd)), [Git Large File Storage](https://git-lfs.github.com/), [Git Annex](https://git-annex.branchable.com/), and [dat](http://dat-data.com/). + +The prefered workflow if data is not in the repository is to have a make command `make data` that will download or create the relevant datasets.