From: Ben Beltran <redacted>
Date: Sat, 5 Sep 2015 19:25:00 +0000 (-0500)
Subject: Adds basic readme (w/o installation instructions)
X-Git-Tag: v1.0.0~4
X-Git-Url: https://git.r.bdr.sh/rbdr/api-notation-atom/commitdiff_plain/c347f4b5d8878b28d308e9f11647475923d9ec8d?ds=sidebyside

Adds basic readme (w/o installation instructions)
---

diff --git a/README.md b/README.md
index 2f20467..64dfd23 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,47 @@
-# api-notation-atom theme
+# API Notation Syntax for Atom
 
-A short description of your theme.
+This is a grammar for api notation, a simple notation I've been using for
+annotating module APIs in specs and other documents.
 
-![A screenshot of your theme](https://f.cloud.github.com/assets/69169/2289498/4c3cb0ec-a009-11e3-8dbd-077ee11741e5.gif)
+## Installing
+
+??
+
+## API Notation Reference
+
+The most recent reference as of now is in this [gist][api-reference], so
+check that to be sure. But here's a reproduction of the notation.
+
+```
+NameOfClass.WithPossibleNamespace
+   + class property
+   - instance property
+  ~> listened events (socket)
+  +> listened events (class/module)
+  -> listened events (instance)
+  <~ dispatched events (socket)
+  <+ dispatched events(class/module)
+  <- dispatched events (instance)
+  :: class method
+   # instance method
+
+Other symbols
+  => returns
+->() callback return
+[xx] optional
+<xx> data type
+
+Recommended order: class first, then sockets, then instance. Internally:
+Properties, events, methods.
+
+// Anything after two forward slashes is a comment
+```
+
+## How does it look like?
+
+Like this.
+
+![Like this.][api-example]
+
+[api-reference]: https://gist.github.com/benbeltran/4694c46fcec131468e34
+[api-example]: https://i.imgur.com/5WXuf4u.png