Remove duplication of prerequisites and testing in docs

[BenSturmfels]

No description provided.

[BenSturmfels]

I've assumed bin/rails spec is preferred over bundle exec rspec as that's what's in README.md. Is that right?

[BenSturmfels]

Unrelated point - I think it would make sense to move all the detailed local development install and configure docs to docs/getting_started.md and leave README.rst as an overview of the project, how to get involved etc. What do you think?

[wwahammy]

I've assumed bin/rails spec is preferred over bundle exec rspec as that's what's in README.md. Is that right?

So, it depends :)

Quick point: bin/rails spec and bundle exec rails spec are practically identical, the bin version actually calls the bundle execversion. Same withbin/rspecandbundle exec rspec`.

If you're running the test suite, bin/rspec and bin/rails spec should be identical I think. The only exception is if the test database isn't setup already, bin/rails spec will do that on first run. On the other hand bin/rspec provides all of the features of rspec. The major one I like is --only-failures which will run only failed tests from the last complete test run.

--next-failure is similar and will run failed tests from the last complete test run and stop at the first failure. Additionally, it will skip any tests which you've gotten working on a previous --next-failure run. It's really helpful for going through broken tests in turn.

I hope that helps!

[wwahammy]

I have one tweak I'd like made but otherwise this is very helpful!

[wwahammy]

Unrelated point - I think it would make sense to move all the detailed local development install and configure docs to docs/getting_started.md and leave README.rst as an overview of the project, how to get involved etc. What do you think?

I'm open to the idea. I tend to prefer it in the main README but I'm fine either way.

[BenSturmfels]

Quick point: bin/rails spec and bundle exec rails spec are practically identical, the bin version actually calls the bundle execversion. Same withbin/rspecandbundle exec rspec`.

If you're running the test suite, bin/rspec and bin/rails spec should be identical I think. The only exception is if the test database isn't setup already, bin/rails spec will do that on first run. On the other hand bin/rspec provides all of the features of rspec. The major one I like is --only-failures which will run only failed tests from the last complete test run.

--next-failure is similar and will run failed tests from the last complete test run and stop at the first failure. Additionally, it will skip any tests which you've gotten working on a previous --next-failure run. It's really helpful for going through broken tests in turn.

Thanks, I've mentioned this in a subsequent commit.

[BenSturmfels]

Unrelated point - I think it would make sense to move all the detailed local development install and configure docs to docs/getting_started.md and leave README.rst as an overview of the project, how to get involved etc. What do you think?

I'm open to the idea. I tend to prefer it in the main README but I'm fine either way.

No worries - I'll leave as-is for now.

[wwahammy]

Thanks @BenSturmfels!