Simplifying the readme towards expected use cases and examples; expand out docs particularly for configuration options

[markurtz]

[tukwila]

@markurtz can i apply for this task? but i don't know the exactly meaning, could you give some example about what use cases or configuration options?

[markurtz]

Hi @tukwila, yes, I'll gather some requirements on this and send over later. We have a large refactor in place for 0.4 which will need a lot of docs updated, and where ever you can help within that, that would be great!

[tukwila]

Hi @tukwila, yes, I'll gather some requirements on this and send over later. We have a large refactor in place for 0.4 which will need a lot of docs updated, and where ever you can help within that, that would be great!

Yes, i'd like to do so; and if any other modules/functions refactor, i'd like to provide my effort.