Update post documentation

Author: Bryan Berg

resources/README.md

@@ -96,11 +96,16 @@ Guiding principles are:
             <td>/stream/0/posts/stream/global</td>
             <td>GET</td>
             <td><a href="/appdotnet/api-spec/blob/master/resources/posts.md#retrieve-the-global-stream">Retrieve the Global stream</a></td>
-        </tr>        
+        </tr>
+        <tr>
+            <td>/stream/0/posts/tag/[hashtag]</td>
+            <td>GET</td>
+            <td><a href="/appdotnet/api-spec/blob/master/resources/posts.md#retrieve-tagged-posts">Retrieve tagged Posts</a></td>
+        </tr>
     </tbody>
 </table>
 
-### [Streams](/appdotnet/api-spec/blob/master/resources/streams.md)
+## [Streams](/appdotnet/api-spec/blob/master/resources/streams.md) -- coming soon
 <table>
     <thead>
         <tr>
@@ -138,7 +143,7 @@ Guiding principles are:
     </tbody>
 </table>
 
-### [Real-time updates](/appdotnet/api-spec/blob/master/resources/subscriptions.md)
+## [Real-time updates](/appdotnet/api-spec/blob/master/resources/subscriptions.md) -- coming soon
 
 <table>
     <thead>
@@ -172,7 +177,7 @@ Guiding principles are:
     </tbody>
 </table>
 
-### [Filters](/appdotnet/api-spec/blob/master/resources/filters.md)
+## [Filters](/appdotnet/api-spec/blob/master/resources/filters.md) -- coming soon
 
 <table>
     <thead>

resources/posts.md

@@ -2,7 +2,7 @@
 
 Posts are currently the best implemented objects on the system. If you're looking to play around with part of the API, start here.
 
-## General parameters - coming soon
+## General parameters
 
 Requests for streams of Posts can be filtered by passing query string parameters along with the request.
 
@@ -589,3 +589,57 @@ Return the 20 most recent <a href="/appdotnet/api-spec/blob/master/objects.md#po
 ...
 ]
 ```
+## Retrieve tagged Posts
+
+Return the 20 most recent <a href="/appdotnet/api-spec/blob/master/objects.md#post">Post</a>s for a specific hashtag.
+
+### URL
+> https://alpha-api.app.net/stream/0/posts/tag/[hashtag]
+
+### Parameters
+
+*See [General Parameters](#general-parameters) for optional parameters you can use with this query.*
+
+### Example
+
+> GET https://alpha-api.app.net/stream/0/posts/tag/newsocialnetwork
+```js
+[{
+    "id": "1", // note this is a string
+    "user": {
+        ...
+    },
+    "created_at": "2012-07-16T17:25:47Z",
+    "text": "@berg FIRST post on this new site #newsocialnetwork",
+    "source": {
+        "name": "Rdio for iOS",
+        "link": "http://rdio.com"
+    },
+    "reply_to": null,
+    "annotations": {
+        "wellknown:geo": {
+            "type": "Point",
+            "coordinates": [102.0, .5]
+        },
+        "rdio:song": ...
+    },
+    "entities": {
+        "mentions": [{
+            "name": "berg",
+            "id": "2",
+            "indices": [0, 4]
+        }],
+        "hashtags": [{
+            "name": "newsocialnetwork",
+            "indices": [34, 50]
+        }],
+        "links": [{
+            "text": "this new site",
+            "url": "https://join.app.net"
+            "indices": [20, 32],
+        }]
+    }
+},
+...
+]
+```