Add documentation for removed collections

documentation/index.html

@@ -1664,7 +1664,7 @@ <h3 id="examples">Examples</h3>
 
 
 
-							<div class="descr"><p>Return a new, empty collection.</p>
+							<div class="descr"><p>Return a new collection, empty or with new elements in a removed state.</p>
 </div>
 
 							<div class="formats">
@@ -1673,6 +1673,15 @@ <h3 id="examples">Examples</h3>
 
 
 										<div class="descr"><p>Get an empty collection.</p>
+</div>
+										<ul class="args">
+										</ul>
+									</div>
+								<div class="format">
+											<div class="name">cy.collection(eleObjs, { removed: true })</div>
+
+
+										<div class="descr"><p>Create a collection with new elements in a removed state</p>
 </div>
 										<ul class="args">
 										</ul>
@@ -1691,6 +1700,14 @@ <h3 id="examples">Examples</h3>
   collection = collection.union(clickedNode);
 });
 </code></pre>
+
+<p>Create a collection of new nodes that have not been added to the graph:</p>
+<pre><code class="language-js">
+	<span class="hljs-keyword">var</span> removedCollection = cy.collection([{ data: { id: 'a' } }, { data: { id: 'b' } }], { removed: true });
+	removedCollection.forEach(element => {
+		console.log(element.removed()); // true
+	};
+</code></pre>
 <button class="run run-inline-code"><span class="fa fa-play"></span></button>
 							</div>
 						</div>