Relates to #244. Updated the documentation

[davidyell]

Updated the documentation to break up a large readme file into smaller more structured pages gathered by topic to hopefully make the docs easier to understand and navigate.

[davidyell]

The contributions.md says that most stuff should be going into the develop branch, but there isn't one.

Not sure if you want to create a matching docs-update branch which I can PR to in case there is some more work to be completed before the changes hit master?

Either way, here is a first effort. I've tried to break the readme up in a logical way and also I've added some more copy to some of the pages to make reading easier now that the files have no wider context.

[davidyell]

I'm not overly familiar with the FileImportBehavior so that doc page is a bit lean.

[coveralls]

Coverage remained the same when pulling 2940bcd on davidyell:docs-update into 3214271 on josegonzalez:master.

[josegonzalez]

Docs should be in rst format so we can use readthedocs.

[davidyell]

What is RST? Is that like Latex or Sphynx or something? A markup language I guess right?

[josegonzalez]

restructured text. It's what we use for the cakephp book.

[davidyell]

Let me know how you get on with this change. I've tested it in my browser, but not on the actual readthedocs website.

[josegonzalez]

Need to rebase, can't automerge this.

[davidyell]

I just realised that the readme.md will need updating to the readthedocs link once it's live 😄

[davidyell]

Ah, well Travis failed one something else it would seem The command "../travis/before_script.sh" failed and exited with 1 during .

[davidyell]

Any progress on this @josegonzalez? Let me know if I need to do anything more.