improve docs

Author: amejiarosario

README.adoc

@@ -1,13 +1,29 @@
 # Data Structures and Algorithms in JavaScript
+
 [![Build Status](https://travis-ci.com/amejiarosario/dsa.js.svg?branch=master)](https://travis-ci.com/amejiarosario/dsa.js)
+[![npm version](https://badge.fury.io/js/dsa.js.svg)](https://badge.fury.io/js/dsa.js)
 
 This repository covers the implementation of the classical algorithms and data structures in JavaScript.
 
-<!-- This goes along with [these posts series](https://adrianmejia.com/tags/tutorial-algorithms/) that explain each implementation in details and also this [book](https://gum.co/dsajs) that explain these topics and some with more examples and illustrations. -->
+## Usage
+
+You can clone the repo or install the code from NPM:
+
+```sh
+npm install dsa.js
+```
+
+and then you can import it into your programs or CLI
+
+```js
+const { LinkedList, Queue, Stack } = require('dsa.js');
+```
+
+For a full list of all the exposed data structures and algorithms [see](https://github.com/amejiarosario/dsa.js/blob/master/src/index.js)
 
 ## Book
 
-You can check out the book that goes deeper into each topic and provide addtional illustrations and explanations.
+You can check out the book that goes deeper into each topic and provide additional illustrations and explanations.
 
 - Algorithmic toolbox to avoid getting stuck while coding.
 - Explains data structures similarities and differences.
@@ -22,65 +38,67 @@ We are covering the following data structures.
 [![Interactive Data Structures](https://user-images.githubusercontent.com/418605/46118890-ba721180-c1d6-11e8-82bc-6a671428b422.png)](https://embed.kumu.io/85f1a4de5fb8430a10a1bf9c5118e015)
 
 ### Linear Data Structures
-1.  **Arrays**: Built-in in most languages so not implemented here.
+
+1. **Arrays**: Built-in in most languages so not implemented here.
     [Post](https://adrianmejia.com/blog/2018/04/28/data-structures-time-complexity-for-beginners-arrays-hashmaps-linked-lists-stacks-queues-tutorial/#Array).
 
-2.  **Linked Lists**: each data node has a link to the next (and
+2. **Linked Lists**: each data node has a link to the next (and
     previous).
     [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/data-structures/linked-lists/linked-list.js)
     |
     [Post](https://adrianmejia.com/blog/2018/04/28/data-structures-time-complexity-for-beginners-arrays-hashmaps-linked-lists-stacks-queues-tutorial/#Linked-Lists).
 
-3.  **Queue**: data flows in a "first-in, first-out" (FIFO) manner.
+3. **Queue**: data flows in a "first-in, first-out" (FIFO) manner.
     [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/data-structures/queues/queue.js)
     |
     [Post](https://adrianmejia.com/blog/2018/04/28/data-structures-time-complexity-for-beginners-arrays-hashmaps-linked-lists-stacks-queues-tutorial/#Queues)
 
-4.  **Stacks**: data flows in a "last-in, first-out" (LIFO) manner.
+4. **Stacks**: data flows in a "last-in, first-out" (LIFO) manner.
     [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/data-structures/stacks/stack.js)
     |
     [Post](https://adrianmejia.com/blog/2018/04/28/data-structures-time-complexity-for-beginners-arrays-hashmaps-linked-lists-stacks-queues-tutorial/#Stacks).
 
 ### Non-Linear Data Structures
-1.  **Trees**: data nodes has zero or more adjacent nodes a.k.a.
+
+1. **Trees**: data nodes has zero or more adjacent nodes a.k.a.
     children. Each node can only have one parent node otherwise is a
     graph not a tree.
     [Code](https://github.com/amejiarosario/algorithms.js/tree/master/src/data-structures/trees)
     |
     [Post](https://adrianmejia.com/blog/2018/06/11/data-structures-for-beginners-trees-binary-search-tree-tutorial/)
 
-    1.  **Binary Trees**: same as tree but only can have two children at
+    1. **Binary Trees**: same as tree but only can have two children at
         most.
         [Code](https://github.com/amejiarosario/algorithms.js/tree/master/src/data-structures/trees)
         |
         [Post](https://adrianmejia.com/blog/2018/06/11/data-structures-for-beginners-trees-binary-search-tree-tutorial/#Binary-Trees)
 
-    2.  **Binary Search Trees** (BST): same as binary tree, but the
+    2. **Binary Search Trees** (BST): same as binary tree, but the
         nodes value keep this order `left < parent < rigth`.
         [Code](https://github.com/amejiarosario/algorithms.js/blob/master/src/data-structures/trees/binary-search-tree.js)
         |
         [Post](https://adrianmejia.com/blog/2018/06/11/data-structures-for-beginners-trees-binary-search-tree-tutorial/#Binary-Search-Tree-BST)
 
-    3.  **AVL Trees**: Self-balanced BST to maximize look up time.
+    3. **AVL Trees**: Self-balanced BST to maximize look up time.
         [Code](https://github.com/amejiarosario/algorithms.js/blob/master/src/data-structures/trees/avl-tree.js)
         |
         [Post](https://adrianmejia.com/blog/2018/07/16/self-balanced-binary-search-trees-with-avl-tree-data-structure-for-beginners/)
 
-    4.  **Red-Black Trees**: Self-balanced BST more loose than AVL to
+    4. **Red-Black Trees**: Self-balanced BST more loose than AVL to
         maximize insertion speed.
         [Code](https://github.com/amejiarosario/algorithms.js/blob/master/src/data-structures/trees/red-black-tree.js)
 
-2.  **Maps**: key-value store.
+2. **Maps**: key-value store.
 
-    1.  **Hash Maps**: implements map using a hash function.
+    1. **Hash Maps**: implements map using a hash function.
         [Code](https://github.com/amejiarosario/algorithms.js/blob/master/src/data-structures/hash-maps/hashmap.js)
         |
         [Post](https://adrianmejia.com/blog/2018/04/28/data-structures-time-complexity-for-beginners-arrays-hashmaps-linked-lists-stacks-queues-tutorial/#HashMaps)
 
-    2.  **Tree Maps**: implement map using a self-balanced BST.
+    2. **Tree Maps**: implement map using a self-balanced BST.
         [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/data-structures/maps/tree-maps/tree-map.js)
 
-3.  **Graphs**: data **nodes** that can have a connection or **edge** to
+3. **Graphs**: data **nodes** that can have a connection or **edge** to
     zero or more adjacent nodes. Unlike trees, nodes can have multiple
     parents, loops.
     [Code](https://github.com/amejiarosario/algorithms.js/blob/master/src/data-structures/graphs/graph.js)
@@ -89,39 +107,39 @@ We are covering the following data structures.
 
 ## Algorithms
 
-  - Sorting algorithms
+- Sorting algorithms
 
-      - Bubble Sort.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/bubble-sort.js)
+  - Bubble Sort.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/bubble-sort.js)
 
-      - Insertion Sort.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/insertion-sort.js)
+  - Insertion Sort.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/insertion-sort.js)
 
-      - Selection Sort.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/selection-sort.js)
+  - Selection Sort.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/selection-sort.js)
 
-      - Merge Sort.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/merge-sort.js)
+  - Merge Sort.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/merge-sort.js)
 
-      - Quicksort.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/quick-sort.js)
+  - Quick sort.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/sorting/quick-sort.js)
 
-  - Greedy Algorithms
+- Greedy Algorithms
 
-      - Fractional Knapsack Problem.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/knapsack-fractional.js)
+  - Fractional Knapsack Problem.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/knapsack-fractional.js)
 
-  - Divide and Conquer
+- Divide and Conquer
 
-      - Fibonacci Numbers.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/fibonacci-recursive.js)
+  - Fibonacci Numbers.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/fibonacci-recursive.js)
 
-  - Dynamic Programming
+- Dynamic Programming
 
-      - Fibonacci with memoization.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/fibanacci-dynamic-programming.js)
+  - Fibonacci with memoization.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/fibanacci-dynamic-programming.js)
 
-  - Backtracking algorithms
+- Backtracking algorithms
 
-      - Word permutations.
-        [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/permutations-backtracking.js)
+  - Word permutations.
+    [Code](https://github.com/amejiarosario/dsa.js/blob/master/src/algorithms/permutations-backtracking.js)

README.md

@@ -19,6 +19,7 @@
     "binary search trees"
   ],
   "author": "Adrian Mejia <hi+dsajs@adrianmejia.com>",
+  "homepage": "https://github.com/amejiarosario/dsa.js",
   "license": "ISC",
   "dependencies": {},
   "devDependencies": {