diff --git a/README.md b/README.md
index 92325d2..2ba3aa2 100644
--- a/README.md
+++ b/README.md
@@ -68,7 +68,19 @@ int main()
 
 ## Various hash maps and their pros and cons
 
-Key points:
+The header `parallel_hashmap/phmap.h` provides the implementation for the following eight hash tables:
+- phmap::flat_hash_set
+- phmap::flat_hash_map
+- phmap::node_hash_set
+- phmap::node_hash_map
+- phmap::parallel_flat_hash_set
+- phmap::parallel_flat_hash_map
+- phmap::parallel_node_hash_set
+- phmap::parallel_node_hash_map
+
+The full types with template parameters can be found in the [parallel_hashmap/phmap_fwd_decl.h](https://raw.githubusercontent.com/greg7mdp/parallel-hashmap/master/parallel_hashmap/phmap_fwd_decl.h) header, which is useful for forward declaring the Parallel Hashmaps when necessaary.
+
+**Key points:**
 
 - The `flat` hash maps may move the keys and values in memory. So if you keep a pointer to something inside a `flat` hash map, this pointer may become invalid when the map is mutated. The `node` hash maps don't, and should be used instead if this is a problem.
 
@@ -83,6 +95,13 @@ Key points:
 
 ## Memory usage
 
-
+|  type  |    memory usage   |
+|--------|-------------------|
+| flat tables  | ![flat_mem_usage](https://github.com/greg7mdp/parallel-hashmap/blob/master/html/img/flat_mem_usage.gif?raw=true) |
+| node tables  |  !node_mem_usage](https://github.com/greg7mdp/parallel-hashmap/blob/master/html/img/node_mem_usage.gif?raw=true) |
+
+The load factor varies between 0.4375 (just after the resize) and 0.875 (just before the resize). 
+
+In addition, when the table resizes, the peak memory usage is an additional 50% of the new size for the *non-parallel* hashmaps, and an additional 3% of the new size for the *parallel* hashmaps (single threaded usage).
 
 
diff --git a/html/img/flat_mem_usage.gif b/html/img/flat_mem_usage.gif
new file mode 100644
index 0000000..f14b098
Binary files /dev/null and b/html/img/flat_mem_usage.gif differ
diff --git a/html/img/node_mem_usage.gif b/html/img/node_mem_usage.gif
new file mode 100644
index 0000000..77dec05
Binary files /dev/null and b/html/img/node_mem_usage.gif differ
diff --git a/parallel_hashmap/phmap_fwd_decl.h b/parallel_hashmap/phmap_fwd_decl.h
index d6b861d..a0e2e40 100644
--- a/parallel_hashmap/phmap_fwd_decl.h
+++ b/parallel_hashmap/phmap_fwd_decl.h
@@ -35,10 +35,10 @@ namespace phmap {
         template <class T>
         using hash_default_eq = typename container_internal::HashEq<T>::Eq;
 
-        // alias for std::allocator so we can forward declare without including other headers
+        // type alias for std::allocator so we can forward declare without including other headers
         template <class T>  using Allocator = typename phmap::Allocator<T>;
 
-        // alias for std::pair so we can forward declare without including other headers
+        // type alias for std::pair so we can forward declare without including other headers
         template<class T1, class T2> using Pair = typename phmap::Pair<T1, T2>;
 
     }  // namespace container_internal