Content/init

content/01-getting-started/01-quickstart.mdx

@@ -23,7 +23,7 @@ This page explains how to get started with Prisma in five minutes. You will lear
 For the demo purposes of this guide, you will use a local [SQLite](https://www.sqlite.org/) database file. This guide does _not_ cover the Prisma setup process. If you're looking to set up Prisma with your own database, you have these options:
 
 - [Setup a new project with Prisma from scratch](./setup-prisma/start-from-scratch-sql)
-- [Add Prisma to an existing project](./setup-prisma/add-to-an-existing-project)
+- [Add Prisma to an existing project](./setup-prisma/add-to-existing-project)
 
 ## Prerequisites
 
@@ -502,21 +502,27 @@ const deletedUser = await prisma.user.delete({
 
 ### Setup Prisma with your own database
 
-To learn how to connect Prisma to your own database, you can follow the respective setup guide:
+To learn how to connect Prisma to your own database, you can follow the respective setup guide.
+
+**Setup a new project from scratch**
+
+The following two guides both explain how you can setup a new project from scratch using your own database as well as howw to send queries with Prisma Client. The first one uses SQL migrations and [introspection](../reference/tools-and-interfaces/introspection), the second one uses [Prisma Migrate](../reference/tools-and-interfaces/prisma-migrate) as the main Prisma workflow.
 
 <ButtonLink color="dark" type="primary" href="./setup-prisma/start-from-scratch-sql">
-    Setup a new project from scratch
+     SQL migrations
 </ButtonLink>
 
-<br />
-<br />
-
-<ButtonLink color="dark" type="primary" href="./setup-prisma/add-to-an-existing-project">
-    Add Prisma to an existing project
+<ButtonLink color="dark" type="primary" href="./setup-prisma/start-from-scratch-prisma-migrate">
+    Prisma Migrate
 </ButtonLink>
 
-<!-- - [Setup a new project with Prisma from scratch](./setup-prisma/start-from-scratch-sql)
-- [Add Prisma to an existing project](./setup-prisma/add-to-an-existing-project) -->
+**Add Prisma to an existing npm project**
+
+When adding Prisma to an already existing no project, you can obtain your initial data model from [introspection](../reference/tools-and-interfaces/introspection).
+
+<ButtonLink color="dark" type="primary" href="./setup-prisma/add-to-existing-project">
+    Add Prisma to existing project
+</ButtonLink>
 
 ---
 

content/01-getting-started/02-setup-prisma/01-add-to-an-existing-project.mdx → content/01-getting-started/02-setup-prisma/01-add-to-existing-project.mdx

@@ -1,5 +1,5 @@
 ---
-title: 'Add to an existing project'
+title: 'Add to existing project'
 metaTitle: 'Add Prisma to an existing project (15 min)'
 metaDescription: 'Learn how to add Prisma to an existing Node.js or TypeScript project by connecting it to your database and generating Prisma Client for database access.'
 dbSwitcher: true

content/01-getting-started/04-example.mdx

@@ -11,6 +11,7 @@ dbSwitcher: true
 
 This page won't be shown in sidebar. For now, h2 tags cannot be written inside `SwitchTech` block. But still can include headings using `<h3>, <h4>` tags and not using `### headings`.
 `<h2>` tags wont be shown in TOC yet.
+
 <ButtonLink color="dark" type="primary" href="https://prisma2.netlify.com/getting-started/quickstart" target="_blank">
     Quickstart (5 min)
 </ButtonLink>

content/03-reference/01-tools-and-interfaces/02-prisma-client/01-api.mdx

@@ -22,7 +22,7 @@ The setup instruction below provide a high-level overview of the steps needed to
 <br />
 <br />
 
-<ButtonLink color="dark" type="primary" href="../../../getting-started/setup-prisma/add-to-an-existing-project">
+<ButtonLink color="dark" type="primary" href="../../../getting-started/setup-prisma/add-to-existing-project">
     Add Prisma to an existing project
 </ButtonLink>
 

content/03-reference/01-tools-and-interfaces/04-introspection.mdx

@@ -8,7 +8,7 @@ metaDescription: 'Learn how you can introspect your database to generate a data
 
 You can introspect your database using the Prisma CLI in order to generate the [data model](./prisma-schema/data-model) in your [Prisma schema](./prisma-schema/prisma-schema-file). The data model is needed to [generate Prisma Client](../prisma-client/configuring-the-prisma-client-api).
 
-Introspection is often used to generate an _initial_ version of the data model when [adding Prisma to an existing project](../../getting-started/setup-prisma/add-to-an-existing-project).
+Introspection is often used to generate an _initial_ version of the data model when [adding Prisma to an existing project](../../getting-started/setup-prisma/add-to-existing-project).
 
 However, it can also be used _repeatedly_ in an application. This is most commonly the case when you're _not_ using [Prisma Migrate](./prisma-migrate) but perform schema migrations using plain SQL or another migration tool. In that case, you also need to re-introspect your database and subsequently re-generate Prisma Client to reflect the schema changes in your [Prisma Client API](../prisma-client/api).
 

content/05-more/05-faq.mdx

@@ -36,10 +36,6 @@ Learn more on the [Debugging](../reference/tools-and-interfaces/prisma-client/de
 
 Prisma Client is not opinionated on how exactly you migrate your database schema (e.g. create new tables, alter columns, ...). You can keep your existing migration system and re-[introspect](../reference/tools-and-interfaces/introspection) your database schema after each schema migration. You can also use Prisma Migrate to run your migrations based on Prisma's declarative [data model definition](../reference/tools-and-interfaces/prisma-schema/data-model).
 
-## Is Prisma Client production-ready? Should I start using it?
-
-Although it's officially in beta, Prisma Client is considered production-ready. This means you can start using it in mission critical applications. Note that there might still be breaking changes as Prisma Client continues to be developed.
-
 ## Does Prisma Client support GraphQL schema delegation and GraphQL binding?
 
 GraphQL [schema delegation](https://www.prisma.io/blog/graphql-schema-stitching-explained-schema-delegation-4c6caf468405/) connects two GraphQL schemas by passing the [`info`](https://www.prisma.io/blog/graphql-server-basics-demystifying-the-info-argument-in-graphql-resolvers-6f26249f613a/) object from a resolver of the first GraphQL schema to a resolver of the second GraphQL schema. Schema delegation also is the foundation for [GraphQL binding](https://github.com/graphql-binding/graphql-binding).
@@ -64,12 +60,6 @@ Each migration is represented via its own directory on your file system inside a
 
 Each of these migration directories contains detailed information about the respective migration, for example which steps are executed (and in what order) as well as a human-friendly Markdown file that summarizes the most important information about the migration, such as the source and the target [data model definition](../reference/tools-and-interfaces/prisma-schema/data-model) of the migration. This information can also be found in the `_Migrations` table in your database/schema.
 
-## Is Prisma Migrate production-ready? Should I start using it?
-
-Prisma Migrate is currently in an experimental state. It has a number of issues that don't make it suitable for production uses. You can track the progress of the release process on [isprisma2ready.com](https://www.isprisma2ready.com).
-
-While it shouldn't be used for mission critical applications yet, Prisma Migrate is definitely in a usable state. You can help us accelerate the release process by using it and [sharing your feedback](https://github.com/prisma/prisma2) with us.
-
 ## Since Prisma 2.0 is released, will Prisma 1 still be maintained?
 
 Yes, Prisma 1 will continue to be maintained. However, most Prisma engineering and support resources will go into the development of [Prisma 2.0](https://github.com/prisma/prisma2).

content/index.mdx

@@ -6,21 +6,18 @@ metaDescription: 'Welcome to the Prisma documentation! Get started with Prisma a
 
 ## Overview
 
-Welcome to the Prisma documentation! You can find an overview of the available content in the sections below. The fastest way to get started with Prisma is the [**Quickstart**](./getting-started/quickstart).
+Welcome to the Prisma documentation! You can find an overview of the available content in the sections below. 
 
 > **If you're using Prisma 1, please refer to the [Prisma 1 documentation](https://www.prisma.io/docs/1.34).**
 
-## Explore
+The fastest way to get started with Prisma is the **Quickstart**. Alternatively you can read the **Introduction** to get a high-level overview of what Prisma is and how it works.
 
-<ButtonLink color="dark" type="primary" href="./setup-prisma/add-to-an-existing-project">
+<ButtonLink color="dark" type="primary" href="./getting-started/quickstart">
     Quickstart (5 min)
 </ButtonLink>
 
-<br />
-<br />
-
-<ButtonLink color="dark" type="primary" href="./setup-prisma/start-from-scratch-sql">
-    Read Prisma introduction
+<ButtonLink color="dark" type="primary" href="./getting-started/quickstart">
+    Prisma introduction
 </ButtonLink>
 
 
@@ -34,7 +31,7 @@ The **Getting started** section contains _practical guides_ to help you get star
 
 - [Quickstart](./getting-started/quickstart) (5 min)
 - Setup Prisma
-  - [Add Prisma to an existing project](./getting-started/setup-prisma/add-to-an-existing-project) (15 min)
+  - [Add Prisma to an existing project](./getting-started/setup-prisma/add-to-existing-project) (15 min)
   - [Start from scratch (SQL migrations)](./getting-started/setup-prisma/start-from-scratch-sql-migrations) (15 min)
 
 ---
@@ -148,3 +145,40 @@ The **More** section contains _meta information_ about Prisma and the documentat
 - [FAQ](./more/faq)
 - [Limitations](./more/limitations)
 - [Roadmap](./more/roadmap)
+
+## Need help?
+
+Prisma has a large and supportive [community](https://prisma.io/community) of enthusiastic application developers which is most active on [Slack](https://slack.prisma.io) and on [GitHub](https://github.com/prisma/prisma).
+
+### Ask a question about Prisma
+
+You can ask questions and initiate [discussions](https://github.com/prisma/prisma2/discussions/) about Prisma-related topics in the `prisma` repository on GitHub.
+
+<ButtonLink color="dark" type="primary" href="https://github.com/prisma/prisma2/discussions/new">
+    Ask a question
+</ButtonLink>
+
+<br />
+<br />
+
+### Create a bug report for Prisma
+
+If you see an error message or run into an issue, please make sure to create a bug report! You can find [best practices for creating bug reports](./more/creating-bug-reports) (like including additional debugging output) in these docs.
+
+<ButtonLink color="dark" type="primary" href="https://github.com/prisma/prisma/issues/new?assignees=&labels=&template=bug_report.md&title=">
+    Create bug report
+</ButtonLink>
+
+
+<br />
+<br />
+
+### Submit a feature request
+
+If Prisma currently doesn't have a certain, be sure to check out the [roadmap](./more/roadmap) to see if this is already planned for the future.
+
+If the feature on the roadmap is linked to a GitHub issue, please make sure to leave a +1 on the issue and ideally a comment with your thoughts about the feature!
+
+<ButtonLink color="dark" type="primary" href="https://github.com/prisma/prisma2/issues/new?assignees=&labels=&template=feature_request.md&title=">
+    Submit feature request
+</ButtonLink>

src/components/customMdx/button.tsx

@@ -35,6 +35,7 @@ const backgroundColorMap = {
 
 export const ButtonWrapper = withProps<ButtonProps>(styled.a)`
     padding: 11px 14px;
+    margin-right: 10px;
     display: inline-flex;
     align-items: center;
     ${p => (p.block ? 'width: 100%;' : '')}