add video callout to custom-signup-signin-pages

clerk / clerk-docs

The documentation content for Clerk, an authentication and user management platform.

https://clerk.com/docs

103 stars 404 forks source link

add video callout to custom-signup-signin-pages #1237

Closed bookercodes closed 3 months ago

bookercodes commented 3 months ago

[!IMPORTANT] 🔎 Previews:

https://clerk.com/docs/pr/1237/references/nextjs/custom-signup-signin-pages#build-your-own-sign-in-and-sign-up-pages-for-your-next-js-app-with-clerk

Inspired by the Next documentation, I recorded a video version of the custom-signup-signin-pages guide to embed on the same page.

The goal is to increase the time on page and strengthen/increase our ranking in Google for the page.

Intuitively, I know some developers prefer to watch video sometimes, so I hope this improves their experience with Clerk.

This PR:

Adds a callout with a link to the video on YouTube.

github-actions[bot] commented 3 months ago

Hey, here’s your docs preview: https://clerk.com/docs/pr/1237

bookercodes commented 3 months ago

A couple of thoughts -

Two "notes", one on top of the other, doesn't look great, but I am not sure what else to do at the moment. I requested a thumbnail for the video from the brand team. Once that's available, we can experiment with embedding the video at the top? I wouldn't want that to be a barrier to getting a link on the page in the short term, though.
A 📹 emoji would draw attention to the fact this callout is pertaining to a video (it's what Next do) but I didn't want to copy them and, besides, we don't use emojis anywhere else in the Clerk documentation as far as I've seen, so I didn't want to introduce them without a second opinion. What do you think?