README.markdown in spotify-12.5.2 vs README.markdown in spotify-12.5.3
- old
+ new
@@ -1,7 +1,11 @@
-Ruby bindings for [libspotify][] ([](http://travis-ci.org/Burgestrand/spotify))
-================================
+Low-level Ruby bindings for [libspotify][], the official Spotify C API
+======================================================================
+[](http://travis-ci.org/Burgestrand/spotify)
+[](https://gemnasium.com/Burgestrand/spotify)
+[](https://codeclimate.com/github/Burgestrand/spotify)
+[](http://badge.fury.io/rb/spotify)
The libspotify C API package allows third party developers to write
applications that utilize the Spotify music streaming service.
[Spotify][] is a really nice music streaming service, and being able to interact
@@ -14,21 +18,28 @@
The Spotify gem has:
- [100% API coverage][], including callback support. You’ll be able to use any function from the libspotify library.
- [Automatic garbage collection][]. Piggybacking on Ruby’s GC to manage pointer lifecycle.
-- [Parallell function call protection][]. libspotify is not thread-safe, but Spotify protects you.
+- [Parallell function call protection][]. libspotify is not thread-safe, but Spotify protects you by providing a re-entrant mutex around function calls.
- [Type conversion and type safety][]. Special pointers for every Spotify type, protecting you from accidental mix-ups.
- [Support for JRuby and Rubinius][]. Thanks to FFI, the gem runs fine on the main three Ruby implementations!
[100% API coverage]: http://rdoc.info/github/Burgestrand/spotify/master/Spotify/API
[Automatic garbage collection]: http://rdoc.info/github/Burgestrand/spotify/master/Spotify/ManagedPointer
[Parallell function call protection]: http://rdoc.info/github/Burgestrand/spotify/master/Spotify#method_missing-class_method
[Type conversion and type safety]: http://rdoc.info/github/Burgestrand/spotify/master/Spotify/ManagedPointer
[Support for JRuby and Rubinius]: https://github.com/Burgestrand/spotify/blob/master/.travis.yml
-The Spotify gem is aimed at experienced developers
+Contact details
+---------------
+
+- __Got questions?__ Ask on the mailing list: [ruby-hallon@googlegroups.com][] (<https://groups.google.com/d/forum/ruby-hallon>)
+- __Found a bug?__ Report an issue: <https://github.com/Burgestrand/spotify/issues/new>
+- __Have feedback?__ I ❤ feedback! Please send it to the mailing list.
+
+Spotify API is best used with a supporting library
--------------------------------------------------
As the raw libspotify API is exposed, the Spotify gem is best coupled with a supporting
library. This library would take a more focused approach to which kind of applications
you can write using it. The Spotify gem itself, however, has very few opinions.
@@ -86,8 +97,8 @@
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
[semantic versioning (semver.org)]: http://semver.org/
[ruby-hallon@googlegroups.com]: mailto:ruby-hallon@googlegroups.com
-[libspotify]: http://developer.spotify.com/en/libspotify/overview/
+[libspotify]: https://developer.spotify.com/technologies/libspotify/
[Spotify]: https://www.spotify.com/
[Hallon]: https://github.com/Burgestrand/Hallon