econchick / new-coder

New Coder tutorials
zlib License
597 stars 394 forks source link

Unclear instructions about folder structure #195

Open demidovakatya opened 8 years ago

demidovakatya commented 8 years ago

You wrote:


When you work through each project, make a new directory within Projects to keep your code away from the sample code. For example:

└── Projects/
    └── new-coder/
        # <-- snip -->
        ├── apis/     # sample code for tutorial #2
        ├── apis_workspace/ # your code for tutorial #2
        ├── dataviz/  # sample code for tutorial #1
        ├── dataviz_workspace/ # your code for tutorial #1
        ├── gui/      # sample code for tutorial #5
        ├── gui_workspace/ # your code for tutorial #5
        ├── network/  # sample code for tutorial #4
        ├── network_workspace/ # your code for tutorial #4
        ├── scrape/   # sample code for tutorial #3
        ├── scrape_workspace/ # your code for tutorial #3
        └── website/  # files that make newcoder.io

At this point, it's easy to understand the instructions and follow them.

But then, in the dataviz tutorial I see these instructions:

$ cd new-coder/dataviz
$ mkvirtualenv DataVizProj

Open up parse.py, found: new-coder/dataviz/tutorial_source/parse.py

I know it is a stupid question, but I just want to learn some cool stuff in Python. Extra difficulties are very demotivating. Could you please explain this stuff about folders? Should I:

Thanks :)

Anmol-Singh-Jaggi commented 8 years ago

+1

eenblam commented 8 years ago

The directory structure described above is intended to keep the code provided by authors separate from the code you write. The main reason one might want both is to be able to check that the end product actually works before bothering to read the tutorial. It can also be a nice sanity check if your version doesn't work at the end.

I realize I'm a bit late to the game here, but you might enjoy just coding along with the tutorial (they're pretty short) and then trying to do your own thing with the libraries you learned. That's a perfectly good way to go. Have fun!