README.md in fakes3-0.2.4 vs README.md in fakes3-0.2.5
- old
+ new
@@ -1,62 +1,34 @@
## Introduction
-FakeS3 is a lightweight server that responds to the same calls Amazon S3 responds to.
-It is extremely useful for testing of S3 in a sandbox environment without actually
-making calls to Amazon, which not only require network, but also cost you precious dollars.
+Fake S3 is a lightweight server that responds to the same API of Amazon S3.
+
+It is extremely useful for testing of S3 in a sandbox environment without actually making calls to Amazon, which not only requires a network connection, but also costs money with every use.
+
The goal of Fake S3 is to minimize runtime dependencies and be more of a
-development tool to test S3 calls in your code rather than a production server
-looking to duplicate S3 functionality. Trying RiakCS, ParkPlace/Boardwalk, or
-Ceph might be a place to start if that is your goal.
+development tool to test S3 calls in your code rather than a production server looking to duplicate S3 functionality.
-FakeS3 doesn't support all of the S3 command set, but the basic ones like put, get,
-list, copy, and make bucket are supported. More coming soon.
+Many commands are supported, including put, get, list, copy, and make bucket.
## Installation
gem install fakes3
## Running
-To run a fakes3 server, you just specify a root and a port.
+To run the server, you just specify a root and a port.
fakes3 -r /mnt/fakes3_root -p 4567
-## Connecting to FakeS3
+## Connecting to Fake S3
-Take a look at the test cases to see client example usage. For now, FakeS3 is
+Take a look at the test cases to see client example usage. For now, Fake S3 is
mainly tested with s3cmd, aws-s3 gem, and right_aws. There are plenty more
libraries out there, and please do mention if other clients work or not.
Here is a running list of [supported clients](https://github.com/jubos/fake-s3/wiki/Supported-Clients "Supported Clients")
-## Running Tests
+## Contributing
-There are some pre-requesites to actually being able to run the unit/integration tests
+Contributions in the form of pull requests, bug reports, documentation, or anything else are welcome! Please read the CONTRIBUTING.md file for more info:
-### On OSX
-
-Edit your /etc/hosts and add the following line:
-
- 127.0.0.1 posttest.localhost
-
-Then ensure that the following packages are installed (boto, s3cmd)
-
- > pip install boto
- > brew install s3cmd
-
-
-Start the test server using
-
- rake test_server
-
-Then in another terminal window run
-
- rake test
-
-It is a still a TODO to get this to be just one command
-
-## More Information
-
-Check out the [wiki](https://github.com/jubos/fake-s3/wiki)
-
-[![Join the chat at https://gitter.im/jubos/fake-s3](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jubos/fake-s3?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+(https://github.com/jubos/fake-s3/CONTRIBUTING.md)[https://github.com/jubos/fake-s3/CONTRIBUTING.md]