chore(docs): starting a migration notes section

docs/docs/misc/migration_notes.md

@@ -0,0 +1,55 @@
+---
+title: Migration notes
+description: Read about migration notes from previous versions, which could solve problems while updating
+keywords: [sandbox, cli, aztec, notes, migration, updating, upgrading]
+---
+
+Aztec is in full-speed development. Literally every version breaks compatibility with the previous ones. This page attempts to target errors and difficulties you might encounter when upgrading, and how to resolve them.
+
+## ≥0.17
+
+### Importing contracts in JS
+
+Contracts are now imported from a file with the type's name.
+
+For example:
+
+```js
+import { TokenContract } from "@aztec/noir-contracts/Token";
+```
+
+instead of
+
+```js
+import { TokenContract } from "@aztec/noir-contracts/types";
+```
+
+### Importing contracts in Nargo.toml
+
+Aztec contracts are now moved outside of the `src` folder, so you need to update your imports.
+
+For example, for `easy_private_token_contract`, you'd import them like this:
+
+```rust
+easy_private_token_contract = {git = "https://github.com/AztecProtocol/aztec-packages/", tag ="v0.16.9", directory = "yarn-project/noir-contracts/src/contracts/easy_private_token_contract"}
+```
+
+Now, just remove the `src` folder, as such:
+
+```rust
+easy_private_token_contract = {git = "https://github.com/AztecProtocol/aztec-packages/", tag ="v0.17.0", directory = "yarn-project/noir-contracts/contracts/easy_private_token_contract"}
+```
+
+## New `@aztec/accounts` package
+
+When previously you would get the default accounts using the `getAccount` method from the `aztec.js` package:
+
+```js
+import { getSchnorrAccount } from "@aztec/aztec.js"
+```
+
+You should now import them from the new package `@aztec/accounts`
+
+```js
+import { getSchnorrAccount } from "@aztec/accounts"
+```

docs/sidebars.js

@@ -81,9 +81,7 @@ const sidebars = {
             type: "doc",
             id: "concepts/foundation/state_model/main",
           },
-          items: [
-            "concepts/foundation/state_model/storage_slots"
-          ]
+          items: ["concepts/foundation/state_model/storage_slots"],
         },
         {
           label: "Accounts",
@@ -113,8 +111,8 @@ const sidebars = {
                 id: "concepts/foundation/communication/public_private_calls/main",
               },
               items: [
-                "concepts/foundation/communication/public_private_calls/slow_updates_tree"
-              ]
+                "concepts/foundation/communication/public_private_calls/slow_updates_tree",
+              ],
             },
             "concepts/foundation/communication/cross_chain_calls",
           ],
@@ -324,9 +322,7 @@ const sidebars = {
                 type: "doc",
                 id: "dev_docs/contracts/syntax/storage/main",
               },
-              items: [
-                "dev_docs/contracts/syntax/storage/storage_slots",
-              ]
+              items: ["dev_docs/contracts/syntax/storage/storage_slots"],
             },
             "dev_docs/contracts/syntax/events",
             "dev_docs/contracts/syntax/functions",
@@ -361,10 +357,10 @@ const sidebars = {
             {
               label: "Common Patterns",
               type: "category",
-                    link: {
-                      type: "doc",
-                      id: "dev_docs/contracts/resources/common_patterns/main",
-                    },
+              link: {
+                type: "doc",
+                id: "dev_docs/contracts/resources/common_patterns/main",
+              },
               items: [
                 "dev_docs/contracts/resources/common_patterns/authwit",
                 //         "dev_docs/contracts/resources/common_patterns/sending_tokens_to_user",
@@ -478,7 +474,7 @@ const sidebars = {
       value: "Miscellaneous",
       defaultStyle: true,
     },
-
+    "misc/migration_notes",
     "misc/glossary",
 
     {