hotwired / turbo-site

turbo.hotwired.dev web site
83 stars 101 forks source link

Turbo may need more usage examples, maybe something interactive like Try Ruby #206

Open scmx opened 2 weeks ago

scmx commented 2 weeks ago

When learning and using Turbo, digging through handbook and reference, I find that it may need more usage examples.

I would ideally like something interactive like Try Ruby https://try.ruby-lang.org/ A user looking to learn Turbo would see idiomatic interactive examples of how Turbo can be used.

For example, I was currently not understanding how to update breadcrumbs outside a turbo frame when going from a show view to an edit view. I solved it by adding target="_top" on the link. EDIT: No this was a case when I shouldn't use a turbo frame.

Lack of idiomatic examples causes users to misunderstand what and when features of Turbo are fitting to use, which leads to worse search results when trying to resolve a problem not tackled by / hard to find in docs.

It's just an idea. Is there some existing resource? I might try to make a PoC of this in a separate repo, at some point, or forget about it.

I found an opened PR from 2 years ago "Add clickable demos to the introduction #100" by @shouichi https://github.com/hotwired/turbo-site/pull/100