Merge pull request #4 from ETH-PEACH-Lab/update-insertNode-and-remove-insertEdge-(deprecated)

fix: update insertNode method signature and documentation for clarity

Author: Yang-Emily

docs/data-structures/linkedlist.md

@@ -47,15 +47,14 @@ LinkedLists support these methods for manipulation:
 
 ### Node Methods
 - `addNode(name, value?)` - Add new node with optional value
-- `insertNode(index, name)` - Insert node at specific position
+- `insertNode(index | id, name, value?)` - Insert node at specific position or after node ID with optional value
 - `removeNode(name)` - Remove specific node
 - `setValue(index | id, value)` - Set value for node at index or node id
 - `setColor(index | id, color)` - Set color for node at index or node id
 - `setArrow(index | id, arrow)` - Set arrow for node at index or node id
 
 ### Value Methods
 - `addValue(value)` - Add value to end of list
-- `insertValue(index | id, value)` - Insert value at specific position or node id
 - `removeValue(value)` - Remove first occurrence of value
 - `removeAt(index)` - Remove node at specific position
 
@@ -124,11 +123,15 @@ list.setColor(2, "green")
 list.setArrow(2, "new")
 
 page
-list.insertNode(1, n1_5)
-list.setValues([10, 15, 20, 30])
+list.insertNode(1, n1_5, 15)  // insert by index
 list.setColors([null, "blue", null, "green"])
 list.setArrows([null, "inserted", null, null])
 
+page
+list.insertNode(n1_5, n1_75, 17.5)  // insert after node ID
+list.setColors([null, "blue", "yellow", null, "green"])
+list.setArrows([null, "inserted", "after n1_5", null, null])
+
 page
 list.removeNode(n2)
 list.setValues([10, 15, 30])
@@ -195,8 +198,7 @@ page
 show sorted
 
 page
-sorted.insertNode(1, n25)
-sorted.setValues([10, 25, 30, 50])
+sorted.insertNode(n10, n25, 25)  // insert after n10 node
 sorted.setColor(1, "red")
 sorted.setArrow(1, "inserted")
 `}

docs/methods.md

@@ -293,7 +293,7 @@ Inserts a value at a specific index.
 obj.insertValue(1, "inserted")
 ```
 
-**Supported by:** Array, Stack, LinkedList
+**Supported by:** Array, Stack
 
 ---
 
@@ -310,12 +310,15 @@ graph.addNode(newNode)  // no value
 
 ---
 
-### `insertNode(index, name)`
-Inserts a node at a specific index.
+### `insertNode(index | id, name, value?)`
+Inserts a node at a specific index or after a specific node ID with optional value.
 
 **Syntax:**
 ```merlin
-list.insertNode(1, newNode)
+list.insertNode(1, newNode)           // by index
+list.insertNode(1, newNode, "value")  // by index with value
+list.insertNode(nodeA, newNode)       // after node ID
+list.insertNode(nodeA, newNode, "value") // after node ID with value
 ```
 
 **Supported by:** LinkedList
@@ -334,18 +337,6 @@ graph.addEdge(nodeA-nodeB)
 
 ---
 
-### `insertEdge(index, edge)`
-Inserts an edge at a specific index.
-
-**Syntax:**
-```merlin
-graph.insertEdge(1, nodeA-nodeB)
-```
-
-**Supported by:** Graph
-
----
-
 ### `setEdges([...])`
 Sets all edges at once.