Quick getting started guide.

[seabbs]

I thought your presentation based overview was really great - it would be excellent if this was included in the README.

Lots of packages have informative READMEs and I find this really helps.

Linked to #6.

[giabaio]

On this one, I think that the page on my website + blog and other tools there do have lots of bits & pieces on BCEA and I think --- aside from the books --- essentially all the information is there. Not a reason not to include a link to the relevant pages. Done now, so closing the issue here, but again do shout if you see something not quite clear!

[seabbs]

Fair enough again.

Personally, I found navigating through the blog to be a little tricky. I have also discussed the package with several people - most of them erroneously thought that a JAGS model was required so some very simple initial details might be good.

In terms of the user experience having everything within the package would be nice for the following reasons:

1. Users can look at examples in vignettes + the README without leaving R.
2. Once the package is installed - the internet is not required.
3. Bringing it all into a standardized structure makes it much easier to spot documentation gaps.
4. Having user instructions in the readme makes it much easier to get up to speed with the package. Users can then look at your other material (and book!) as they need more detail.
5. A quick overview in the README means that users finding the package from CRAN can very quickly understand what the package does. If this is not supplied they may pass over the package.
6. It is typically what robust R packages do. Whilst herding is not all good having this would help signal that this is a good package.

I'm not sure what the downsides to having this in the README are but obviously, this is all up to you!

[giabaio]

No --- there's no downside, really. Happy to discuss if you have a draft of the README that you would like to push through!