Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Updating documentation indexes

  • Loading branch information...
commit e93b03d3e9a9d7bcff766c033c88542a13cc6a69 1 parent 78fb578
@carols10cents carols10cents authored
Showing with 125 additions and 44 deletions.
  1. +82 −22 docs/app_index.html
  2. +6 −1 docs/index.html
  3. +37 −21 docs/test_index.html
View
104 docs/app_index.html
@@ -26,27 +26,32 @@
Jump To …
<div id="jump_wrapper">
<div id="jump_page">
- <a class="source" href="app/controllers/application_controller.html">application_controller.rb</a>
- <a class="source" href="app/controllers/auth_controller.html">auth_controller.rb</a>
- <a class="source" href="app/controllers/feeds_controller.html">feeds_controller.rb</a>
- <a class="source" href="app/controllers/salmon_controller.html">salmon_controller.rb</a>
- <a class="source" href="app/controllers/searches_controller.html">searches_controller.rb</a>
- <a class="source" href="app/controllers/sessions_controller.html">sessions_controller.rb</a>
- <a class="source" href="app/controllers/static_controller.html">static_controller.rb</a>
- <a class="source" href="app/controllers/subscriptions_controller.html">subscriptions_controller.rb</a>
- <a class="source" href="app/controllers/updates_controller.html">updates_controller.rb</a>
- <a class="source" href="app/controllers/users_controller.html">users_controller.rb</a>
- <a class="source" href="app/controllers/webfinger_controller.html">webfinger_controller.rb</a>
- <a class="source" href="app/decorators/application_decorator.html">application_decorator.rb</a>
- <a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a>
- <a class="source" href="app/decorators/user_decorator.html">user_decorator.rb</a>
- <a class="source" href="app/models/author.html">author.rb</a>
- <a class="source" href="app/models/authorization.html">authorization.rb</a>
- <a class="source" href="app/models/feed.html">feed.rb</a>
- <a class="source" href="app/models/notifier.html">notifier.rb</a>
- <a class="source" href="app/models/update.html">update.rb</a>
- <a class="source" href="app/models/user.html">user.rb</a>
- <a class="source" href="app/models/webfinger.html">webfinger.rb</a>
+ <a class="source" href="app/controllers/application_controller.html">application_controller.rb</a>
+ <a class="source" href="app/controllers/auth_controller.html">auth_controller.rb</a>
+ <a class="source" href="app/controllers/feeds_controller.html">feeds_controller.rb</a>
+ <a class="source" href="app/controllers/salmon_controller.html">salmon_controller.rb</a>
+ <a class="source" href="app/controllers/searches_controller.html">searches_controller.rb</a>
+ <a class="source" href="app/controllers/sessions_controller.html">sessions_controller.rb</a>
+ <a class="source" href="app/controllers/static_controller.html">static_controller.rb</a>
+ <a class="source" href="app/controllers/subscriptions_controller.html">subscriptions_controller.rb</a>
+ <a class="source" href="app/controllers/updates_controller.html">updates_controller.rb</a>
+ <a class="source" href="app/controllers/users_controller.html">users_controller.rb</a>
+ <a class="source" href="app/controllers/webfinger_controller.html">webfinger_controller.rb</a>
+ <a class="source" href="app/decorators/application_decorator.html">application_decorator.rb</a>
+ <a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a>
+ <a class="source" href="app/decorators/author_json_decorator.html">author_json_decorator.rb</a>
+ <a class="source" href="app/decorators/time_decorator.html">time_decorator.rb</a>
+ <a class="source" href="app/decorators/update_decorator.html">update_decorator.rb</a>
+ <a class="source" href="app/decorators/user_decorator.html">user_decorator.rb</a>
+ <a class="source" href="app/models/author.html">author.rb</a>
+ <a class="source" href="app/models/authorization.html">authorization.rb</a>
+ <a class="source" href="app/models/feed.html">feed.rb</a>
+ <a class="source" href="app/models/notifier.html">notifier.rb</a>
+ <a class="source" href="app/models/salmon_author.html">salmon_author.rb</a>
+ <a class="source" href="app/models/salmon_interpreter.html">salmon_interpreter.rb</a>
+ <a class="source" href="app/models/update.html">update.rb</a>
+ <a class="source" href="app/models/user.html">user.rb</a>
+ <a class="source" href="app/models/webfinger.html">webfinger.rb</a>
</div>
</div>
</div>
@@ -64,7 +69,7 @@
<a class="pilcrow" href="#section-intro">&#182;</a>
</div>
<p><a href="index.html">Return to the main rstat.us index</a></p>
- <p>The <code>app</code> directory contains so much that it gets its own index. Rails uses the <a href="http://guides.rubyonrails.org/getting_started.html#the-mvc-architecture">MVC architecture</a> so there are directories for the <code>controllers</code>, <code>models</code>, and <code>views</code>.</p>
+ <p>The <code>app</code> directory contains so much that it gets its own index. Rails uses the <a href="http://guides.rubyonrails.org/getting_started.html#the-mvc-architecture">MVC architecture</a> so there are directories for the <code>controllers</code>, <code>models</code>, and <code>views</code>. We're also starting to use the Decorator pattern for view logic, so there's a directory of <code>decorators</code>.</p>
</td>
<td class=code>
</td>
@@ -245,6 +250,39 @@
<div class='highlight'><pre>|- <a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a></pre></div>
</td>
</tr>
+ <tr id='section-decorators-author-json'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-decorators-author-json">&#182;</a>
+ </div>
+ <p>The author json decorator handles the json representation of an author. This decorator makes use of some of the author decorator methods.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>|- <a class="source" href="app/decorators/author_json_decorator.html">author_json_decorator.rb</a></pre></div>
+ </td>
+ </tr>
+ <tr id='section-decorators-time'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-decorators-time">&#182;</a>
+ </div>
+ <p>The time decorator has the logic needed for displaying time attributes and markup with different time formats for updates.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>|- <a class="source" href="app/decorators/time_decorator.html">time_decorator.rb</a></pre></div>
+ </td>
+ </tr>
+ <tr id='section-decorators-update_json'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-decorators-update_json">&#182;</a>
+ </div>
+ <p>The update json decorator creates the json representation of an update. It calls the author json decorator to embed the author.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>|- <a class="source" href="app/decorators/update_json_decorator.html">update_json_decorator.rb</a></pre></div>
+ </td>
+ </tr>
<tr id='section-decorators-user'>
<td class=docs>
<div class="pilwrap">
@@ -311,6 +349,28 @@
<div class='highlight'><pre>|- <a class="source" href="app/models/notifier.html">notifier.rb</a></pre></div>
</td>
</tr>
+ <tr id='section-models-salmon-author'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-models-salmon-author">&#182;</a>
+ </div>
+ <p>The salmon author model is a non-database model. It's a wrapper around an author that is returned from a Salmon response through the OStatus gem. This class makes it easier to treat an author from a Salmon response in the same way as an rstat.us Author without needing to know about OStatus authors' structure.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>|- <a class="source" href="app/models/salmon_author.html">salmon_author.rb</a></pre></div>
+ </td>
+ </tr>
+ <tr id='section-models-salmon-interpreter'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-models-salmon-interpreter">&#182;</a>
+ </div>
+ <p>The salmon interpreter model is another non-database model that does a lot of the work of carrying out the actions that a Salmon notification tells us about.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>|- <a class="source" href="app/models/salmon_interpreter.html">salmon_interpreter.rb</a></pre></div>
+ </td>
+ </tr>
<tr id='section-models-update'>
<td class=docs>
<div class="pilwrap">
View
7 docs/index.html
@@ -39,11 +39,16 @@
<a class="source" href="app/controllers/webfinger_controller.html">webfinger_controller.rb</a>
<a class="source" href="app/decorators/application_decorator.html">application_decorator.rb</a>
<a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a>
+ <a class="source" href="app/decorators/author_json_decorator.html">author_json_decorator.rb</a>
+ <a class="source" href="app/decorators/time_decorator.html">time_decorator.rb</a>
+ <a class="source" href="app/decorators/update_decorator.html">update_decorator.rb</a>
<a class="source" href="app/decorators/user_decorator.html">user_decorator.rb</a>
<a class="source" href="app/models/author.html">author.rb</a>
<a class="source" href="app/models/authorization.html">authorization.rb</a>
<a class="source" href="app/models/feed.html">feed.rb</a>
<a class="source" href="app/models/notifier.html">notifier.rb</a>
+ <a class="source" href="app/models/salmon_author.html">salmon_author.rb</a>
+ <a class="source" href="app/models/salmon_interpreter.html">salmon_interpreter.rb</a>
<a class="source" href="app/models/update.html">update.rb</a>
<a class="source" href="app/models/user.html">user.rb</a>
<a class="source" href="app/models/webfinger.html">webfinger.rb</a>
@@ -64,7 +69,7 @@
<a class="pilcrow" href="#section-intro">&#182;</a>
</div>
<p>Welcome to rstat.us' code!</p>
- <p>Rstat.us uses <a href="http://rubyonrails.org/">Ruby on Rails 3.1</a>. It follows the structure of a standard Rails app, so if you have not used Rails before, you may want to take a look at the <a href="http://guides.rubyonrails.org/getting_started.html">Getting Started Rails Guide</a>. Or feel free to dive in to rstat.us!</p>
+ <p>Rstat.us uses <a href="http://rubyonrails.org/">Ruby on Rails 3.2</a>. It follows the structure of a standard Rails app, so if you have not used Rails before, you may want to take a look at the <a href="http://guides.rubyonrails.org/getting_started.html">Getting Started Rails Guide</a>. Or feel free to dive in to rstat.us!</p>
<p>You can skip to the documentation for any individual code file that has documentation by using the "Jump to..." menu in the upper right of any documentation page.</p>
<p>This page is an index of the directories in rstat.us' repository with a quick explanation of what each directory is responsible for.</p>
</td>
View
58 docs/test_index.html
@@ -26,27 +26,32 @@
Jump To &hellip;
<div id="jump_wrapper">
<div id="jump_page">
- <a class="source" href="app/controllers/application_controller.html">application_controller.rb</a>
- <a class="source" href="app/controllers/auth_controller.html">auth_controller.rb</a>
- <a class="source" href="app/controllers/feeds_controller.html">feeds_controller.rb</a>
- <a class="source" href="app/controllers/salmon_controller.html">salmon_controller.rb</a>
- <a class="source" href="app/controllers/searches_controller.html">searches_controller.rb</a>
- <a class="source" href="app/controllers/sessions_controller.html">sessions_controller.rb</a>
- <a class="source" href="app/controllers/static_controller.html">static_controller.rb</a>
- <a class="source" href="app/controllers/subscriptions_controller.html">subscriptions_controller.rb</a>
- <a class="source" href="app/controllers/updates_controller.html">updates_controller.rb</a>
- <a class="source" href="app/controllers/users_controller.html">users_controller.rb</a>
- <a class="source" href="app/controllers/webfinger_controller.html">webfinger_controller.rb</a>
- <a class="source" href="app/decorators/application_decorator.html">application_decorator.rb</a>
- <a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a>
- <a class="source" href="app/decorators/user_decorator.html">user_decorator.rb</a>
- <a class="source" href="app/models/author.html">author.rb</a>
- <a class="source" href="app/models/authorization.html">authorization.rb</a>
- <a class="source" href="app/models/feed.html">feed.rb</a>
- <a class="source" href="app/models/notifier.html">notifier.rb</a>
- <a class="source" href="app/models/update.html">update.rb</a>
- <a class="source" href="app/models/user.html">user.rb</a>
- <a class="source" href="app/models/webfinger.html">webfinger.rb</a>
+ <a class="source" href="app/controllers/application_controller.html">application_controller.rb</a>
+ <a class="source" href="app/controllers/auth_controller.html">auth_controller.rb</a>
+ <a class="source" href="app/controllers/feeds_controller.html">feeds_controller.rb</a>
+ <a class="source" href="app/controllers/salmon_controller.html">salmon_controller.rb</a>
+ <a class="source" href="app/controllers/searches_controller.html">searches_controller.rb</a>
+ <a class="source" href="app/controllers/sessions_controller.html">sessions_controller.rb</a>
+ <a class="source" href="app/controllers/static_controller.html">static_controller.rb</a>
+ <a class="source" href="app/controllers/subscriptions_controller.html">subscriptions_controller.rb</a>
+ <a class="source" href="app/controllers/updates_controller.html">updates_controller.rb</a>
+ <a class="source" href="app/controllers/users_controller.html">users_controller.rb</a>
+ <a class="source" href="app/controllers/webfinger_controller.html">webfinger_controller.rb</a>
+ <a class="source" href="app/decorators/application_decorator.html">application_decorator.rb</a>
+ <a class="source" href="app/decorators/author_decorator.html">author_decorator.rb</a>
+ <a class="source" href="app/decorators/author_json_decorator.html">author_json_decorator.rb</a>
+ <a class="source" href="app/decorators/time_decorator.html">time_decorator.rb</a>
+ <a class="source" href="app/decorators/update_decorator.html">update_decorator.rb</a>
+ <a class="source" href="app/decorators/user_decorator.html">user_decorator.rb</a>
+ <a class="source" href="app/models/author.html">author.rb</a>
+ <a class="source" href="app/models/authorization.html">authorization.rb</a>
+ <a class="source" href="app/models/feed.html">feed.rb</a>
+ <a class="source" href="app/models/notifier.html">notifier.rb</a>
+ <a class="source" href="app/models/salmon_author.html">salmon_author.rb</a>
+ <a class="source" href="app/models/salmon_interpreter.html">salmon_interpreter.rb</a>
+ <a class="source" href="app/models/update.html">update.rb</a>
+ <a class="source" href="app/models/user.html">user.rb</a>
+ <a class="source" href="app/models/webfinger.html">webfinger.rb</a>
</div>
</div>
</div>
@@ -113,6 +118,17 @@
<div class='highlight'><pre>fabricators/</pre></div>
</td>
</tr>
+ <tr id='section-test-lib'>
+ <td class=docs>
+ <div class="pilwrap">
+ <a class="pilcrow" href="#section-test-lib">&#182;</a>
+ </div>
+ <p>The <code>lib</code> test directory has unit tests for the classes in lib that don't require any functionality from Rails. Want to see how awesome this is? Run <code>rake test:lib</code> and notice how much faster that runs compared to, say, <code>rake test:models</code> since <code>lib</code> doesn't need to load Rails.</p>
+ </td>
+ <td class=code>
+ <div class='highlight'><pre>lib/</pre></div>
+ </td>
+ </tr>
<tr id='section-test-models'>
<td class=docs>
<div class="pilwrap">
Please sign in to comment.
Something went wrong with that request. Please try again.