#  Getting Started

`jiraSOAP` should run on Ruby 1.9.2+ and MacRuby 0.8+. It is available through rubygems or you can build from source:

```bash
    # Using rubygems
    gem install jiraSOAP

    # Building from source
    git clone git://github.com/Marketcircle/jiraSOAP.git
    rake install
```

Once installed, you can run a quick demo (making appropriate substitutions):

    require 'jiraSOAP'

The first thing that you need to do is create a JIRAService object:

    db = JIRA::JIRAService.new 'http://jira.yourSite.com:8080'

Then you need to log in (a failed login will raise an exception):

    db.login 'mrada', 'secret'

Once you are logged in, you can start querying the server for information:

     issues = db.issues_from_jql_search 'reporter = currentUser()', 100
     issues.each { |issue|
       #do something...
       puts issue.summary
     }

Don't forget to log out when you are done:

    db.logout

To find out what APIs are available, check out the {JIRA::RemoteAPI}
module, as well as the {JIRA::RemoteAPIAdditions} module for
conveniences that `jiraSOAP` has added.

#  Getting Started

`jiraSOAP` should run on Ruby 1.9.2+ and MacRuby 0.8+. It is available through rubygems or you can build from source:

```bash
    # Using rubygems
    gem install jiraSOAP

    # Building from source
    git clone git://github.com/Marketcircle/jiraSOAP.git
    rake install
```

Once installed, you can run a quick demo (making appropriate substitutions):

```ruby
    require 'jiraSOAP'
```

The first thing that you need to do is create a JIRAService object:

```ruby
    db = JIRA::JIRAService.new 'http://jira.yourSite.com:8080'
```

Then you need to log in (a failed login will raise an exception):

```ruby
    db.login 'mrada', 'secret'
```

Once you are logged in, you can start querying the server for information:

```ruby
     issues = db.issues_from_jql_search 'reporter = currentUser()', 100
     issues.each { |issue|
       #do something...
       puts issue.summary
     }
```

Don't forget to log out when you are done:

```ruby
    db.logout
```

To find out what APIs are available, check out the {JIRA::RemoteAPI}
module, as well as the {JIRA::RemoteAPIAdditions} module for
conveniences that `jiraSOAP` has added.

Add some syntax highlighting tweaks to the guide
Add some syntax highlighting tweaks to the guide