Vercel Deployment Instructions can be improved

[Izhaki]

Which doc needs an update?

deploy-to-vercel

What needs to be updated?

I have just attempted connecting Vercel to PlanetBase and failed.

Going to describe my user journey (talk aloud):

• Went to https://planetscale.com/docs/tutorials/deploy-to-vercel#manually-connect-to-vercel
• It says "Select the framework you're using from the "Connect with" dropdown."
  • 'Urm... let's have a look at the options... OK... NodeJS should work no?'
  • Later I saw the screenshot shows "Prisma" (which I'm using), but that is a very small detail in that screenshot.
• Connection failed with "server does not allow insecure connections, client must use SSL/TLS"
• Let's google it
  • https://github.com/planetscale/discussion/discussions/354
    • Talks about certificates and does mention sslaccept=strict, but I have no idea where the certificate is.
  • https://davidparks.dev/blog/planetscale-deployment-with-prisma/
    • mentions sslmode=require&sslcert=/etc/pki/tls/certs/ca-bundle.crt
    • searched for that in the docs and found https://planetscale.com/docs/concepts/secure-connections#redhat--fedora--centos--mageia--vercel--netlify
    • So tried it out and this works.

However:

• If you choose Prisma in Connect it says sslaccept=strict.
• The method above uses sslmode=require&sslcert=/etc/pki/tls/certs/ca-bundle.crt
• If you look at the screenshot, it says (at the bottom) "View the certificate validation settings for the sslcert details."

So still not sure which is correct. And if sslaccept=strict is correct, should we still have the certificate validation link?

I'm sure for someone in the know this makes perfect sense, but this wasn't as smooth as many other journeys through your (excellent) documentation.