Improve README documentation.

Some things that seemed important in the first version matter less
now, where as the directory conventions and task syntax matter more.