Clear documentation on blacksmith requirements can reduce invalid bugs along the road

[taboca]

I have patched your documentation changing slightly the sections so it is clear that it is important to have a directory structure before executing "blacksmith /path/to/site" I have noticed about 3 bugs that I feel may have existed because of the docs problem:

#83
#79
#69

[cronopio]

LGTM

[cbebry]

+1
I was about to make another issue if I didn't find others with the same problem -- as I encountered this as well.

It's been 4 months since this pull request. Is there a reason why it isn't merged or addressed? Or made clearer in the documentation?

[koenmetsu]

I'd love to try out Blacksmith, but the documentation leaves me with a lot of questions. Like a couple of others in the issues page, I haven't yet been able to make this work because I figured Blacksmith would generate the necessary files + some example pages.

This open pull request makes me wonder if this project is still alive at all :(