correct docs about edge cases and gotchas

Author: giusepperaso

docs/edge-cases.md

@@ -1,6 +1,6 @@
 # Edge cases
 
-Structura supports some edge cases that are not always well handled by other libraries. On the contrary, some edge cases are not well supported.
+Structura supports some edge cases that are not always well handled by other libraries.
 
 ## Returning and modifying in the same producer
 
@@ -68,21 +68,35 @@ const newState5 = produce(state, (draft) => {
 })
 ```
 
-## Assigning draftable objects to non draftable objects
+## Transpositions
 
-If you try assigning a draftable object to a non draftable object as a sub property, you will be left with a dangling proxy
+You can reassign the key of a sub-object and the result will be what you expect
+
+However, this will not work if you assign to an object external from the draft
 
 ```typescript
 const state = [[1], [2]]
 
-// this does not work well because the new object
-// will remain with a proxy attached via its prop;
+// this works well
+const newState1 = produce(state, (draft) => {
+    const first = draft[0]
+    draft[0] = draft[1]
+    draft[1] = first
+})
 
+// this also works
+const newState2 = produce(state, (draft) => {
+    const first = draft[0]
+    draft[0] = draft[1]
+    draft[1] = first
+    first.push(9999)
+})
+
+// this does not work well because the new object
+// will remain with a proxy attached via its prop
 const newState3 = produce(state, (draft) => {
     const first = draft[0]
     const newObj = { prop: first }
     draft.push(newObj as any)
 })
-
-// newState3[2].prop is a proxy
 ```

docs/when-to-use.md

@@ -15,5 +15,5 @@
 - test coverage is still not 100%
 - docs could be better
 - does not support IE and pre ES6 browsers and will never do
-- does not yet support ~~some proxy traps and~~ an edge case that Immer supports ([this](./edge-cases.md#assigning-draftable-objects-to-non-draftable-objects)), but this is very likely to change in the future
+- does not yet support ~~some proxy traps and~~ an edge case that Immer supports ([this](./gotchas.md#potential-dangling-proxy-references-if-you-assign-unproxied-objects-into-the-draft)), but this is very likely to change in the future
 - generated patches are not compliant to any RFC, but ~~in the future this may change or there could be a converter~~ there is already a converter included in the library; besides applyPatches also accept standard JSON Patches