Browse files

revert "added a basic contribution guide"

this reverts commit 2589047.
  • Loading branch information...
1 parent df71e38 commit dec3ee94d832e9f4c4057f73e4d1a522c5736ae6 @rubiii rubiii committed Mar 7, 2013
Showing with 44 additions and 33 deletions.
  1. +44 −33
@@ -1,46 +1,57 @@
-# Contribution Guide
+# Savon
-This page describes how to contribute changes to Savon.
+Heavy metal SOAP client
-Please do not create a pull request without reading this guide first.
-Make sure to read the documentation for your version at [](
-and post questions to the [mailing list](!forum/savonrb).
+[Documentation]( | [RDoc]( |
+[Mailing list](!forum/savonrb) | [Twitter](
-**Bug fixes**
+[![Build Status](](
+[![Gem Version](](
+[![Code Climate](](
-If you really think you found a bug, please make sure to add as many information as possible
-to the ticket. You're a developer, we are developers and you know we need tests to reproduce
-problems and make sure they don't come back.
-So if you can reproduce your problem in a spec, that would be awesome! If you can't, please
-let us know how we could make this easier for you. Also, provide code and the WSDL of the
-service your working with so others can try to come up with a spec for your problem.
+## Installation
-After we have a failing spec, it obviously needs to be fixed. Make sure your new spec is the
-only failing one under the `spec` directory. Travis only runs the "unit tests" at `spec/savon`,
-but Savon actually has with some additional "integration/example specs" at `spec/integration`,
-which you need to run locally to make sure the integration with real world services still works.
+Savon is available through [Rubygems]( and can be installed via:
-Notice that these specs are not run by Travis, because the service's are not guaranteed to work
-all the time and the specs will timeout after a few seconds when the service is currently down.
+$ gem install savon
-Please follow this basic workflow for pull requests:
+or add it to your Gemfile like this:
-* [Fork the project](
-* Create a feature branch and make your bug fix
-* Add tests for it!
-* Update the [Changelog](
-* [Send a pull request](
-* [Check that your pull request passes the build](
+gem 'savon', '~> 2.1.0'
-**Improvements and feature requests**
+## Usage example
-If you have an idea for an improvement or a new feature, please feel free to
-[create a new issue]( and describe your idea
-so that other people can give their insights and opinions. This is also important to avoid
-duplicate work.
+``` ruby
+require 'savon'
-Pull requests and issues on GitHub are meant to be used to discuss problems and ideas,
-so please make sure to participate and follow up on questions. In case noone comments
-on your ticket, please keep updating the ticket with additional information.
+# create a client for the service
+client = Savon.client(wsdl: '')
+# => [:find_user, :list_users]
+# call the 'findUser' operation
+response =, message: { id: 42 })
+# => { find_user_response: { id: 42, name: 'Hoff' } }
+For more examples, you should check out the [integration tests](
+## Documentation
+Please make sure to read the documentation for your version:
+* [Version 2](
+* [Version 1](
+And if you find any problems with it or if you think something's missing,
+feel free to [help out and improve the documentation](

0 comments on commit dec3ee9

Please sign in to comment.