0
@@ -16,17 +16,36 @@ Halcyon has several aims and goals, including:
0
 * *Be flexible* -- since it uses HTTP, it's very simple to be flexible
0
 * *Be easy to implement* -- also easy since we're developing in "Ruby":http://ruby-lang.org/ here
0
 
0
+Simply put, <strong>Halcyon is a web application framework with a
0
+twist</strong>. The twist is simply that Halcyon applications communicate
0
+solely through "JSON":http://json.org/, both incoming and outgoing.
0
+
0
 
0
 h2. What Is Halcyon For?
0
 
0
-This is the question most often asked about Halcyon, <em>what is Halcyon for?</em> Simply put, <strong>Halcyon is a web application framework with a twist</strong>. The twist is simply that Halcyon applications communicate solely through "JSON":http://json.org/, both incoming and outgoing.
0
+This is the question most often asked about Halcyon, <em>what is Halcyon
0
+for?</em> If "Rails":http://rubyonrails.org/ (and "Merb":http://merbivore.com/
0
+"et al":http://ramaze.net/#other-frameworks) is for quickly developing web
0
+applications, Halcyon aims to provide a framework for developing
0
+service-oriented applications (SOAs) such as APIs or other non-interfaced
0
+services.
0
+
0
+The "Twitter":http://twitter.com/ API is a great example of a SOA where
0
+tweets can be submitted without needing any web interface. The power of this
0
+type of application is that other client-side applications can be developed to
0
+provide an interface to the web service.
0
+
0
+Halcyon aims to make writing these types of application interfaces and other
0
+similar services trivial.
0
 
0
-This doesn't, however, answer what Halcyon is <em>for</em>.
0
 
0
 
0
 h2. Functionality &amp; Performance
0
 
0
-With Mongrel leading the pack and Rack holding things up, JSON doing the fast talking and with plenty of room to spare, how could you not be interested, even about this new framework? Still not convinced? OK, fair enough, here's some code for you.
0
+With Mongrel leading the pack and Rack holding things up, JSON doing the fast
0
+talking and with plenty of room to spare, how could you not be interested, even
0
+about this new framework? Still not convinced? OK, fair enough, here's some
0
+code for you.
0
 
0
 <% coderay(:lang => "ruby", :line_numbers => "inline", :tab_width => 2) do -%>
0
 class Message < Sequel::Model; end
0
@@ -58,21 +77,29 @@ You can then run it with:
0
 
0
 <pre><code>$ halcyon start -p 4647</code></pre>
0
 
0
-That's all it takes to open up the door to let you communicate with your applications that implement or use the simple client.
0
+That's all it takes to open up the door to let you communicate with your
0
+applications that implement or use the simple client.
0
 
0
 Read the "Docs":/docs/.
0
 
0
 
0
 h2. Supported Platforms
0
 
0
-Halcyon is primarily written in Ruby, but Halcyon also supports multiple platforms due to the fact that it communicates via HTTP and packages its messages in JSON. Halcyon currently has Ruby, PHP, and Java clients available, with more clients planned.
0
+Halcyon is primarily written in Ruby, but Halcyon also supports multiple
0
+platforms due to the fact that it communicates via HTTP and packages its
0
+messages in JSON. Halcyon currently has Ruby, PHP, and Java clients available,
0
+with more clients planned.
0
 
0
-You can see the various client implementations at http://github.com/mtodd/halcyon-clients (except for the Ruby client, which is part of the Halcyon gem).
0
+You can see the various client implementations at
0
+"the GitHub project":http://github.com/mtodd/halcyon-clients (except for the
0
+Ruby client, which is part of the Halcyon gem).
0
 
0
 
0
 h2. Metrics
0
 
0
-Ohloh's pretty cool and we use it to track the development metrics of Halcyon. Check out some of the more interesting details on our project page. You can find the link at the top of the page.
0
+Ohloh's pretty cool and we use it to track the development metrics of Halcyon.
0
+Check out some of the more interesting details on our project page. You can
0
+find the link at the top of the page.
0
 
0
 For your viewing pleasure, here are some of the Ohloh project factoids:
0