git.r.bdr.sh - rbdr/api-notation.vscode/blob - README.md

   1 # API Notation Syntax for Atom
   2
   3 This is a grammar for api notation, a simple notation I've been using for
   4 annotating module APIs in specs and other documents.
   5
   6 ## Installing
   7
   8 ### From Command Line
   9
  10 `code --install-extension rbdr.api-notation`
  11
  12 ### From GUI
  13
  14 #### Open the Extension Manager from Palette Manager
  15
  16 1. Press `⌘⇧P` on OSX or `⌃⇧P` on Windows/Linux to open the palette manager
  17 2. Look for `Install Ext4ensions
  18
  19 #### Open the Package Manager from Preferences
  20
  21 1. Go to `Code -> Preferences -> Extensions` menu item
  22
  23 #### Install it
  24
  25 1. Search for `api-notation` in the search bar
  26 2. Click Install
  27
  28
  29 ## Usage
  30
  31 Open a `.api` file, or set it as your syntax.
  32
  33 ## API Notation Reference
  34
  35 The most recent reference as of now is in this [gist][api-reference], so
  36 check that to be sure. But here's a reproduction of the notation.
  37
  38 ```
  39 NameOfClass.WithPossibleNamespace
  40    + class property
  41    - instance property
  42   ~> listened events (socket)
  43   +> listened events (class/module)
  44   -> listened events (instance)
  45   <~ dispatched events (socket)
  46   <+ dispatched events(class/module)
  47   <- dispatched events (instance)
  48   :: class method
  49    # instance method
  50
  51 Other symbols
  52   => returns
  53 ->() callback return
  54 [xx] optional
  55 <xx> data type
  56
  57 Recommended order: class first, then sockets, then instance. Internally:
  58 Properties, events, methods.
  59
  60 // Anything after two forward slashes is a comment
  61 ```
  62
  63 ## How does it look like?
  64
  65 Like this.
  66
  67 ![Like this.][api-example]
  68
  69 [api-reference]: https://gist.github.com/rbdr/4694c46fcec131468e34
  70 [api-example]: https://i.imgur.com/63TyFMe.png