polish upgrade guide

content/200-orm/500-reference/500-preview-features/050-client-preview-features.mdx

@@ -16,21 +16,21 @@ For more information, see [ORM releases and maturity levels](/orm/more/releases)
 
 The following [Preview](/orm/more/releases#preview) feature flags are available for Prisma Client and Prisma schema:
 
-| Feature                                                                                      | Released into Preview                                          |                            Feedback issue                             |
-| -------------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :-------------------------------------------------------------------: |
-| [`fullTextSearchPostgres`](/orm/prisma-client/queries/full-text-search)                      | [2.30.0](https://github.com/prisma/prisma/releases/tag/2.30.0) |    [Submit feedback](https://github.com/prisma/prisma/issues/8877)    |
-| [`metrics`](/orm/prisma-client/observability-and-logging/metrics)                            | [3.15.0](https://github.com/prisma/prisma/releases/tag/3.15.0) |   [Submit feedback](https://github.com/prisma/prisma/issues/13579)    |
-| [`multiSchema`](https://github.com/prisma/prisma/issues/1122#issuecomment-1231773471)        | [4.3.0](https://github.com/prisma/prisma/releases/tag/4.3.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15077)    |
-| [`postgresqlExtensions`](/orm/prisma-schema/postgresql-extensions)                           | [4.5.0](https://github.com/prisma/prisma/releases/tag/4.5.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15835)    |
-| [`deno`](/orm/prisma-client/deployment/edge/deploy-to-deno-deploy)                           | [4.5.0](https://github.com/prisma/prisma/releases/tag/4.5.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15844)    |
-| [`views`](/orm/prisma-schema/data-model/views)                                               | [4.9.0](https://github.com/prisma/prisma/releases/tag/4.9.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/17335)    |
-| `driverAdapters`                                                                             | [5.4.0](https://github.com/prisma/prisma/releases/tag/5.4.0)   |    [Submit feedback](https://github.com/prisma/prisma/issues/3108)    |
-| `relationJoins`                                                                              | [5.7.0](https://github.com/prisma/prisma/releases/tag/5.7.0)   | [Submit feedback](https://github.com/prisma/prisma/discussions/22288) |
-| `nativeDistinct`                                                                             | [5.7.0](https://github.com/prisma/prisma/releases/tag/5.7.0)   | [Submit feedback](https://github.com/prisma/prisma/discussions/22287) |
-| `omitApi`                                                                                    | [5.13.0](https://github.com/prisma/prisma/releases/tag/5.13.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/23924) |
-| `prismaSchemaFolder`                                                                         | [5.15.0](https://github.com/prisma/prisma/releases/tag/5.15.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/24413) |
-| `typedSql`                                                                                   | [5.19.0](https://github.com/prisma/prisma/releases/tag/5.19.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25106) |
-| `strictUndefinedChecks`                                                                      | [5.20.0](https://github.com/prisma/prisma/releases/tag/5.20.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25271) |
+| Feature                                                                               | Released into Preview                                          |                            Feedback issue                             |
+| ------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :-------------------------------------------------------------------: |
+| [`metrics`](/orm/prisma-client/observability-and-logging/metrics)                     | [3.15.0](https://github.com/prisma/prisma/releases/tag/3.15.0) |   [Submit feedback](https://github.com/prisma/prisma/issues/13579)    |
+| [`multiSchema`](https://github.com/prisma/prisma/issues/1122#issuecomment-1231773471) | [4.3.0](https://github.com/prisma/prisma/releases/tag/4.3.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15077)    |
+| [`postgresqlExtensions`](/orm/prisma-schema/postgresql-extensions)                    | [4.5.0](https://github.com/prisma/prisma/releases/tag/4.5.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15835)    |
+| [`deno`](/orm/prisma-client/deployment/edge/deploy-to-deno-deploy)                    | [4.5.0](https://github.com/prisma/prisma/releases/tag/4.5.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/15844)    |
+| [`views`](/orm/prisma-schema/data-model/views)                                        | [4.9.0](https://github.com/prisma/prisma/releases/tag/4.9.0)   |   [Submit feedback](https://github.com/prisma/prisma/issues/17335)    |
+| `driverAdapters`                                                                      | [5.4.0](https://github.com/prisma/prisma/releases/tag/5.4.0)   |    [Submit feedback](https://github.com/prisma/prisma/issues/3108)    |
+| `relationJoins`                                                                       | [5.7.0](https://github.com/prisma/prisma/releases/tag/5.7.0)   | [Submit feedback](https://github.com/prisma/prisma/discussions/22288) |
+| `nativeDistinct`                                                                      | [5.7.0](https://github.com/prisma/prisma/releases/tag/5.7.0)   | [Submit feedback](https://github.com/prisma/prisma/discussions/22287) |
+| `omitApi`                                                                             | [5.13.0](https://github.com/prisma/prisma/releases/tag/5.13.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/23924) |
+| `prismaSchemaFolder`                                                                  | [5.15.0](https://github.com/prisma/prisma/releases/tag/5.15.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/24413) |
+| `typedSql`                                                                            | [5.19.0](https://github.com/prisma/prisma/releases/tag/5.19.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25106) |
+| `strictUndefinedChecks`                                                               | [5.20.0](https://github.com/prisma/prisma/releases/tag/5.20.0) | [Submit feedback](https://github.com/prisma/prisma/discussions/25271) |
+| [`fullTextSearchPostgres`](/orm/prisma-client/queries/full-text-search)               | [6.0.0](https://github.com/prisma/prisma/releases/tag/2.30.0)  |    [Submit feedback](https://github.com/prisma/prisma/issues/8877)    |
 
 To enable a Preview feature, [add the feature flag to the `generator` block](#enabling-a-prisma-client-preview-feature) in your `schema.prisma` file. [Share your feedback on all Preview features on GitHub](https://github.com/prisma/prisma/issues/3108).
 

content/200-orm/800-more/300-upgrade-guides/200-upgrading-versions/500-upgrading-to-prisma-6.mdx

@@ -79,13 +79,28 @@
 
 If you're using PostgreSQL and are defining [implicit many-to-many relations](/orm/prisma-schema/data-model/relations/many-to-many-relations#implicit-many-to-many-relations) in your Prisma schema, Prisma ORM maintains the [relation table](/orm/prisma-schema/data-model/relations/many-to-many-relations#relation-tables) for you under the hood. This relation table has `A` and `B` columns to represent the tables of the models that are part of this relation.
 
-
 Previous versions of Prisma ORM used to create a _unique index_ on these two columns. In Prisma v6, this unique index is changing to a _primary key_ in order to [simplify for the default replica identity behaviour](https://github.com/prisma/prisma/issues/25196).
 
 <details>
 <summary>Expand for an example</summary>
 
-As an example, consider this relation table of an implicit m-n relation between `Post` and `Tag` models:
+As an example, consider the following Prisma schema with an implicit m-n relation between `Post` and `Tag` models:
+
+```prisma
+model Post {
+  id         Int    @id @default(autoincrement())
+  title      String
+  categories Tag[]
+}
+
+model Tag {
+  id    Int    @id @default(autoincrement())
+  name  String
+  posts Post[]
+}
+```
+
+In this case, Prisma ORM maintains the following relation table for you under the hood:
 
 ```sql
 -- CreateTable
@@ -152,7 +167,7 @@
 
 ### Full-text search on PostgreSQL
 
-The `fullTextSearch` Preview feature is promoted to General Availability only for MySQL. This means that if you're using PostgreSQL and currently make use of this Preview feature, you now need to use the new `fullTextSearchPostgres` Preview feature:
+The [`fullTextSearch`]((/orm/prisma-client/queries/full-text-search)) Preview feature is promoted to General Availability only for MySQL. This means that if you're using PostgreSQL and currently make use of this Preview feature, you now need to use the new [`fullTextSearchPostgres`](/orm/prisma-client/queries/full-text-search#enabling-full-text-search-for-postgresql) Preview feature:
 
 #### Before
 
@@ -190,8 +205,42 @@
 
 Prisma v6 replaces the usage of [`Buffer`](https://nodejs.org/api/buffer.html)  with [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) to represent fields of type `Bytes`. Make sure to replace all your occurences of the `Buffer` type with the new `Uint8Array`.
 
+<details>
+<summary>Expand to view how to convert between <code>Buffer</code> and <code>Uint8Array</code></summary>
+
+### Conversion from Buffer to Uint8Array
+
+You can directly use the `Buffer` instance as a `Uint8Array`:
+
+```ts
+const buffer: Buffer = Buffer.from([1, 2, 3, 4]);
+const uint8Array: Uint8Array = buffer; // No conversion needed
+```
+
+If you need a copy of the data (to avoid shared memory):
+
+```ts
+const uint8ArrayCopy: Uint8Array = new Uint8Array(buffer);
+```
+
+### Conversion from Uint8Array to Buffer
+
+You can create a `Buffer` from a `Uint8Array` using `Buffer.from`:
+
+```ts
+const uint8Array: Uint8Array = new Uint8Array([1, 2, 3, 4]);
+const buffer: Buffer = Buffer.from(uint8Array);
+```
+
+If you're using Node.js, this process is very efficient since Buffer and Uint8Array share the same underlying memory.
+
+</details>
+
 #### Before
 
+<TabbedContent code>
+<TabItem value="Code">
+
 ```ts
 import { PrismaClient } from '@prisma/client'
 
@@ -218,8 +267,25 @@
 main()
 ```
 
+</TabItem>
+<TabItem value="Prisma schema">
+
+```prisma
+model User {
+  id    Int   @id @default(autoincrement())
+  bytes Bytes
+}
+```
+
+</TabItem>
+</TabbedContent>
+
+
 #### After
 
+<TabbedContent code>
+<TabItem value="Code">
+
 ```ts
 import { PrismaClient } from '@prisma/client'
 
@@ -246,6 +312,21 @@
 main()
 ```
 
+</TabItem>
+<TabItem value="Prisma schema">
+
+```prisma
+model User {
+  id    Int   @id @default(autoincrement())
+  bytes Bytes
+}
+```
+
+</TabItem>
+</TabbedContent>
+
+
+
 ### Removed `NotFoundError`
 
 In Prisma v6, we removed the `NotFoundError` in favor of `PrismaClientKnownRequestError` with error code [`P2025`](/orm/reference/error-reference#p2025) in [`findUniqueOrThrow()`](/orm/reference/prisma-client-reference#finduniqueorthrow) and [`findFirstOrThrow()`](/orm/reference/prisma-client-reference#findfirstorthrow). If you've relied on catching `NotFoundError` instances in your code, you need to adjust the code accordingly.