add PDP concepts overview #5970

nikolasburk · 2024-05-02T12:03:58Z

This PR introduces a number of changes to the PDP docs:

refactors "concepts" and move Workspaces, Projects and Environments out of the sidebar and puts all relevant information into About page
elaborates on Workspaces, Projects and Environments with simple language and gives examples of "typical" use/workflows
gives more context on billing with concrete examples
adds concrete instructions to configure the Accelerate connection pool size

vercel · 2024-05-02T12:04:05Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

1 Ignored Deployment

Name	Status	Preview	Comments	Updated (UTC)
docs	⬜️ Ignored (Inspect)	Visit Preview		May 7, 2024 6:25am

github-actions · 2024-05-02T12:04:16Z

Absolute URL check

No absolute URLs to prisma.io/docs found.

github-actions · 2024-05-02T12:04:18Z

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

/platform/concepts/workspaces /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts/projects /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts/environments /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts /docs/##( TODO: Path of page that replaces deleted page )##

github-actions · 2024-05-02T12:04:20Z

original	preview
content/300-accelerate/250-connection-pooling.mdx	content/300-accelerate/250-connection-pooling.mdx
content/400-pulse/250-database-setup/100-general-database-instructions.mdx	content/400-pulse/250-database-setup/100-general-database-instructions.mdx
content/400-pulse/250-database-setup/300-railway.mdx	content/400-pulse/250-database-setup/300-railway.mdx
content/400-pulse/250-database-setup/400-neon.mdx	content/400-pulse/250-database-setup/400-neon.mdx
content/500-platform/10-about.mdx	content/500-platform/10-about.mdx
content/500-platform/30-maturity-levels.mdx	content/500-platform/30-maturity-levels.mdx
content/500-platform/40-limits.mdx	content/500-platform/40-limits.mdx
content/500-platform/50-support.mdx	content/500-platform/50-support.mdx

github-actions · 2024-05-02T12:05:00Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 1.7%, saving 7.43 KB.

Filename	Before	After	Improvement	Visual comparison
`static/img/platform/pdp-concepts.png`	429.51 KB	422.08 KB	-1.7%	View diff

148 images did not require optimisation.

cloudflare-pages · 2024-05-02T12:05:04Z

Deploying docs with Cloudflare Pages

Latest commit:	`a4c6461`
Status:	✅ Deploy successful!
Preview URL:	https://d67261c2.docs-51g.pages.dev
Branch Preview URL:	https://pdp-concepts.docs-51g.pages.dev

View logs

content/300-accelerate/250-connection-pooling.mdx

content/500-platform/10-about.mdx

content/300-accelerate/250-connection-pooling.mdx

content/500-platform/10-about.mdx

content/500-platform/50-support.mdx

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

content/300-accelerate/250-connection-pooling.mdx

content/500-platform/10-about.mdx

content/500-platform/50-support.mdx

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

Co-authored-by: Petra Donka <donkapetra@gmail.com>

content/500-platform/10-about.mdx

mhessdev · 2024-05-06T17:43:00Z

I would possibly note what environment is default for a project. Does it have a name?

mhessdev · 2024-05-06T17:45:47Z

Maybe I missed it, but I'm not sure. I see something stating that you need a single API key for a single environment, even if that environment has both Prisma Pulse and Prisma Accelerate enabled. (although I might be wrong on that working)

content/500-platform/10-about.mdx

Co-authored-by: Petra Donka <donkapetra@gmail.com>

github-actions · 2024-05-10T16:20:00Z

Images automagically compressed by Calibre's image-actions ✨

Compression reduced images by 9.8%, saving 5.92 KB.

Filename	Before	After	Improvement	Visual comparison
`static/img/platform/pdp-concepts.png`	60.64 KB	54.72 KB	-9.8%	View diff

148 images did not require optimisation.

petradonka · 2024-05-13T09:54:15Z

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

/platform/concepts/workspaces /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts/projects /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts/environments /docs/##( TODO: Path of page that replaces deleted page )##
/platform/concepts /docs/##( TODO: Path of page that replaces deleted page )##

@nikolasburk, did we add these redirects?

meletj · 2024-05-13T10:03:48Z

content/500-platform/10-about.mdx

+In each workspace, you can:
+
+- view and manage all projects (and their environments) in that workspace.
+- manage billing, i.e. select a [subscription plan](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site), configure payment methods, or view the invoice history.


@nikolasburk when you fix the redirects, can you also update the UTM here to have source=docs so we're consistent and medium=platform-docs? Thank you

meletj · 2024-05-13T10:04:34Z

content/500-platform/10-about.mdx

+
+- view and manage all environments in that project.
+
+The number of project you can create in a workspace depends on the [subscription plan](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site) configured in that workspace.


same as above re: UTM

meletj · 2024-05-13T10:04:56Z

content/500-platform/10-about.mdx

+
+## Billing
+
+The [subscription plan](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site) you select in your workspace determines how many projects and environments you can create in that workspace:


Same as above re UTM

meletj · 2024-05-13T10:05:06Z

content/500-platform/10-about.mdx

+- if you subscribe to our **Pro** plan on the 15th day of a month, you'll only be charged the base plan price for the days left in that month.
+- if you downgrade your subscription plan (e.g. from **Business** to **Pro**) after 10 days of a 30-day month, you'll be charged for 10 days of the base price of the **Business** plan and 20 days for the base price of the **Pro** plan.
+
+Visit our [pricing page](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site) for more details.


same re: UTM

nikolasburk · 2024-05-13T10:18:23Z

Thanks for the ping @meletj and @petradonka!

I added redirects and update utm in this PR: #5999

remove top block component

e18bd30

Optimised images with calibre/image-actions

74729ca

nikolasburk added 3 commits May 3, 2024 09:38

add concrete instructions for changing the connection pool size

ffcfe5f

Merge branch 'pdp-concepts' of github.com:prisma/docs into pdp-concepts

e601f2e

refactor platform console concepts

89b3d0d

nikolasburk mentioned this pull request May 3, 2024

Anchor links on the same page are rendered as external links and open in new tab #5973

Closed

nurul3101 reviewed May 3, 2024

View reviewed changes

nikolasburk and others added 5 commits May 3, 2024 12:33

Update content/300-accelerate/250-connection-pooling.mdx

170d0c5

better overview of billing

36c0207

Merge branch 'pdp-concepts' of github.com:prisma/docs into pdp-concepts

d6aa3ae

Update content/500-platform/10-about.mdx

779fbe7

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

Update content/300-accelerate/250-connection-pooling.mdx

f38d08d

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

petradonka requested changes May 5, 2024

View reviewed changes

nikolasburk and others added 11 commits May 6, 2024 09:54

Update content/500-platform/10-about.mdx

8084f34

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

Update content/500-platform/50-support.mdx

3c1a576

Co-authored-by: Nurul Sundarani <sundarani@prisma.io>

Update content/300-accelerate/250-connection-pooling.mdx

e8bab84

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/300-accelerate/250-connection-pooling.mdx

0403ece

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

9615544

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

324eb5a

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

bc8e573

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

bb21890

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

1ce7bd6

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

b0e0f42

Co-authored-by: Petra Donka <donkapetra@gmail.com>

incorporate feedback

1ecdb5a

nikolasburk and others added 2 commits May 6, 2024 11:44

Update content/500-platform/10-about.mdx

9b4eeba

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

fd323a9

Co-authored-by: Petra Donka <donkapetra@gmail.com>

nikolasburk requested a review from petradonka May 6, 2024 09:49

petradonka reviewed May 6, 2024

View reviewed changes

nikolasburk added 2 commits May 6, 2024 15:54

update pricing plan to subscription plan

04b1709

resolve merge conflict

c7dc10b

petradonka reviewed May 6, 2024

View reviewed changes

content/500-platform/10-about.mdx Outdated Show resolved Hide resolved

content/500-platform/10-about.mdx Show resolved Hide resolved

content/500-platform/10-about.mdx Outdated Show resolved Hide resolved

content/500-platform/10-about.mdx Outdated Show resolved Hide resolved

nikolasburk and others added 4 commits May 7, 2024 08:03

Update content/500-platform/10-about.mdx

a30a893

Co-authored-by: Petra Donka <donkapetra@gmail.com>

Update content/500-platform/10-about.mdx

70f9f53

incorporate feedback

f93ca84

incorporate feedback

083f087

nikolasburk requested a review from petradonka May 7, 2024 06:25

nikolasburk added 4 commits May 7, 2024 08:25

incorporate feedback

5d1dee3

incorporate feedback

0328967

update illustration

a28d470

update illustration

8f83e2a

Optimised images with calibre/image-actions

3d780a8

petradonka approved these changes May 12, 2024

View reviewed changes

nikolasburk added 3 commits May 13, 2024 10:00

resolve merge conflict

565c106

Merge branch 'pdp-concepts' of github.com:prisma/docs into pdp-concepts

a674911

fix build errors

a4c6461

nikolasburk merged commit 6ead326 into main May 13, 2024
9 checks passed

nikolasburk deleted the pdp-concepts branch May 13, 2024 08:09

meletj reviewed May 13, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

add PDP concepts overview #5970

add PDP concepts overview #5970

nikolasburk commented May 2, 2024 •

edited

Loading

vercel bot commented May 2, 2024 •

edited

Loading

github-actions bot commented May 2, 2024

github-actions bot commented May 2, 2024 •

edited

Loading

github-actions bot commented May 2, 2024 •

edited

Loading

github-actions bot commented May 2, 2024

cloudflare-pages bot commented May 2, 2024 •

edited

Loading

mhessdev commented May 6, 2024

mhessdev commented May 6, 2024

github-actions bot commented May 10, 2024

petradonka commented May 13, 2024

Redirect check

meletj May 13, 2024 •

edited

Loading

meletj May 13, 2024

meletj May 13, 2024

meletj May 13, 2024

nikolasburk commented May 13, 2024


		- view and manage all environments in that project.

		The number of project you can create in a workspace depends on the [subscription plan](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site) configured in that workspace.


		## Billing

		The [subscription plan](https://prisma.io/pricing?utm_source=prisma-docs&utm_medium=docs-site) you select in your workspace determines how many projects and environments you can create in that workspace:

add PDP concepts overview #5970

add PDP concepts overview #5970

Conversation

nikolasburk commented May 2, 2024 • edited Loading

vercel bot commented May 2, 2024 • edited Loading

github-actions bot commented May 2, 2024

Absolute URL check

github-actions bot commented May 2, 2024 • edited Loading

Redirect check

github-actions bot commented May 2, 2024 • edited Loading

github-actions bot commented May 2, 2024

cloudflare-pages bot commented May 2, 2024 • edited Loading

Deploying docs with Cloudflare Pages

mhessdev commented May 6, 2024

mhessdev commented May 6, 2024

github-actions bot commented May 10, 2024

petradonka commented May 13, 2024

Redirect check

meletj May 13, 2024 • edited Loading

Choose a reason for hiding this comment

meletj May 13, 2024

Choose a reason for hiding this comment

meletj May 13, 2024

Choose a reason for hiding this comment

meletj May 13, 2024

Choose a reason for hiding this comment

nikolasburk commented May 13, 2024

nikolasburk commented May 2, 2024 •

edited

Loading

vercel bot commented May 2, 2024 •

edited

Loading

github-actions bot commented May 2, 2024 •

edited

Loading

github-actions bot commented May 2, 2024 •

edited

Loading

cloudflare-pages bot commented May 2, 2024 •

edited

Loading

meletj May 13, 2024 •

edited

Loading