<commit_before>=================================
teracy-dev - get development fun!
=================================

This ``teracy-dev`` repository was created for developing Django applications with ease and fun.
We're going to use ``virtualbox`` for running Django projects, ``chef`` and ``vagrant`` for
installing and configuring any neccessary packages.

By using this approach, we can work on any host machine with different OS, even Windows :-).
However, Windows is NOT recommended for best development experience. You don't have to install tons
of development stuffs on your host machine but on ``virtualbox`` only.

It's better to work on any *nix compatible OS (Mac OSX, Ubuntu, Fedora, Redhat, you name it :-D).


Ubuntu 12.04 is a **strongly** recommended OS for development, get it now at:
http://www.ubuntu.com/download/desktop


Getting started
---------------

- Minmum requirement:

You're required to install ``virtualBox``, ``vagrant``.

If you're on Windows, you must install ``git`` to use ``git-bash`` terminal window.

- Optional recommendation:

You should install ``git``.


1. If you're on ``Ubuntu``:

    Install ``git``, ``virtualbox``, ``vagrant`` with the provided bash script below:
    ::
        $ cd /tmp
        $ wget https://raw.github.com/teracy-official/teracy-dev/master/scripts/setup_working_env_chef.sh
        $ bash setup_working_env_chef.sh


1. Or to get started manually, you need to finish 2 required following simple steps:

    1.1. Install **latest** ``vagrant`` version at: http://downloads.vagrantup.com/

    1.2. Install ``virtualbox`` with the version of **4.2.10** at:
         https://www.virtualbox.org/wiki/Download_Old_Builds_4_2

    1.3. [Required on Windows only] Install latest ``git`` version at http://git-scm.com/ to use
    ``git-bash`` as terminal window. However, it's highly recommended to install on your machine.

2. From home directory (``~/``), download or clone this repository and ``$ vagrant up``. You should
prepare yourself a cup of coffee as for the first time, it would take a little long time 
(~20-30 mins) to ``$ vagrant up``. 

- No ``git`` installed: 
Download and unzip this repository at https://github.com/teracy-official/teracy-dev/archive/master.zip<commit_msg>Improve the README guide for windows users and add more content [#14]<commit_after>=================================
teracy-dev - get development fun!
=================================

This ``teracy-dev`` repository was created for developing Django applications with ease and fun.
We're going to use ``virtualbox`` for running Django projects, ``chef`` and ``vagrant`` for
installing and configuring any neccessary packages.

By using this approach, we can work on any host machine with different OS, even Windows :-).
However, Windows is NOT recommended for best development experience. You don't have to install tons
of development stuffs on your host machine but on ``virtualbox`` only.

It's better to work on any *nix compatible OS (Mac OSX, Ubuntu, Fedora, Redhat, you name it :-D).


Ubuntu 12.04 is a **strongly** recommended OS for development, get it now at:
http://www.ubuntu.com/download/desktop


Getting started
---------------

- Minmum requirement:

You're required to install ``virtualBox``, ``vagrant``.

If you're on Windows, you must install ``git`` to use ``git-bash`` terminal window.

Note: After installing ``vagrant`` on Windows, you need to restart your computer.

- Optional recommendation:

You should install ``git``.


1. If you're on ``Ubuntu``:

    Install ``git``, ``virtualbox``, ``vagrant`` with the provided bash script below:
    ::
        $ cd /tmp
        $ wget https://raw.github.com/teracy-official/teracy-dev/master/scripts/setup_working_env_chef.sh
        $ bash setup_working_env_chef.sh


1. Or to get started manually, you need to finish 2 required following simple steps:

    1.1. Install **latest** ``vagrant`` version at: http://downloads.vagrantup.com/

    1.2. Install ``virtualbox`` with the version of **4.2.10** at:
         https://www.virtualbox.org/wiki/Download_Old_Builds_4_2

    1.3. [Required on Windows only] Install latest ``git`` version at http://git-scm.com/ to use
    ``git-bash`` as terminal window. However, it's highly recommended to install on your machine.

2. From home directory (``~/``), download or clone this repository and ``$ vagrant up``. You should
prepare yourself a cup of coffee as for the first time, it would take a little long time 
(~20-30 mins with internet speed ~700-800KB/s) to ``$ vagrant up``.

**For slow internet connection**

For slow internet connection (~200KB/s or lower), you could use a download accelerator to
download .box file (400-500MB) first with the link:
https://opscode-vm-bento.s3.amazonaws.com/vagrant/opscode_ubuntu-12.04-i386_chef-11.4.4.box

And before ``$ vagrant up``, you must execute the command below:
::
    $ vagrant box add opscode-ubuntu-1204 path_to_the_downloaded_file.box

The output could be similar like this:
::
    Downloading or copying the box...
    Extracting box...te: 66.3M/s, Estimated time remaining: 0:00:01)
    Successfully added box 'opscode-ubuntu-1204' with provider 'virtualbox'!


- No ``git`` installed: 
Download and unzip this repository at https://github.com/teracy-official/teracy-dev/archive/master.zip
{'fraction_non_alphanumeric': 0.13850779928584853, 'fraction_numerical': 0.017477917684645742, 'mean_word_length': 3.9553072625698324, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 7, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 14, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '40208', 'n_tokens_mistral': 1647, 'n_tokens_neox': 1502, 'n_words': 626}