supabase icon indicating copy to clipboard operation
supabase copied to clipboard

feat: docs - added in example description

Open Hallidayo opened this issue 2 years ago • 12 comments

What kind of change does this PR introduce?

Supabase docs - dart

Issue: #10929

What is the current behavior?

On the examples their is sometimes an description of the example that is not in the docs

What is the new behavior?

The examples now show a description which gives useful tips about the examples:

https://user-images.githubusercontent.com/22655069/207620858-c0f009cb-cc42-4e43-9ac8-2c7c86414277.mov

Additional context

Closes #10929

Hallidayo avatar Dec 14 '22 14:12 Hallidayo

@Hallidayo is attempting to deploy a commit to the Supabase Team on Vercel.

A member of the Team first needs to authorize it.

vercel[bot] avatar Dec 14 '22 14:12 vercel[bot]

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

Name Status Preview Comments Updated
docs ✅ Ready (Inspect) Visit Preview 💬 Add your feedback Dec 23, 2022 at 4:04AM (UTC)
supabase-studio-prod ✅ Ready (Inspect) Visit Preview 💬 Add your feedback Dec 23, 2022 at 4:04AM (UTC)
supabase-studio-staging ✅ Ready (Inspect) Visit Preview 💬 Add your feedback Dec 23, 2022 at 4:04AM (UTC)
zone-www-dot-com ✅ Ready (Inspect) Visit Preview 💬 Add your feedback Dec 23, 2022 at 4:04AM (UTC)
1 Ignored Deployment
Name Status Preview Comments Updated
about ⬜️ Ignored (Inspect) Dec 23, 2022 at 4:04AM (UTC)

vercel[bot] avatar Dec 14 '22 14:12 vercel[bot]

nice !!!

@Hallidayo i think we need to clean up the descriptions in the yaml files in /spec first. Some of them have leftover html/jsx in there.

For example. all of this needs removing, and leaving in the top bit of text which is the actual description for the client lib function :D

MildTomato avatar Dec 14 '22 16:12 MildTomato

@MildTomato - Cool, yeah that would look wild without the clean. I'll have a look through and clean up.

Hallidayo avatar Dec 14 '22 16:12 Hallidayo

@Hallidayo that would be amazing 💯

Think the js v1, js v2, dart v0 and dart v1 spec files are all involved and need cleaning. Luckily it's purely deleting things though which makes it a little enjoyable.

You can ignore any files that are named *--old.yml

MildTomato avatar Dec 14 '22 16:12 MildTomato

@MildTomato cool no problem, I'll do a commit for each spec file so its clear.

Hallidayo avatar Dec 14 '22 17:12 Hallidayo

@MildTomato - Just had a check of the four spec files and it was only spec/supabase_js_v2.yml that I could see which had some jsx in the descriptions, so I think we should be all good.

Hallidayo avatar Dec 14 '22 20:12 Hallidayo

Epic @Hallidayo! Thank you for this!

Marked as approved, but it's a big change so I'm going to wait till tomorrow morning to merge it. Appreciated!

saltcod avatar Dec 19 '22 20:12 saltcod

@saltcod i'll check it again and merge if i'm confident

MildTomato avatar Dec 20 '22 01:12 MildTomato

Screenshot 2022-12-20 at 9 35 34 AM

I might jump in this branch today and clean up how we display this. Think we can do something better here. We also didn't really hit the actual final design for this so I'll try in figma how the description can fit in

MildTomato avatar Dec 20 '22 01:12 MildTomato

Just want to call out the original issue is "Description of examples is missing in Flutter docs"

But this change appears to be on the JS spec. Will this one solve the linked issue?

kiwicopple avatar Dec 21 '22 16:12 kiwicopple

@kiwicopple it will. The JS spec file is here b/c it needed cleanup that the others didn't need (for some reason).

@MildTomato something like this make sense? (my mockup on the left, this branch's current state on the right)

CleanShot 2022-12-21 at 15 29 23@2x

saltcod avatar Dec 21 '22 19:12 saltcod