I've been working on the new Rails Getting Started guide and it's now ready for review! 🎉 github.com/rails/rails/... - ThreadSky

excid3.com • 85 days ago

I've been working on the new Rails Getting Started guide and it's now ready for review! 🎉

https://github.com/rails/rails/pull/53846

Comments

alan.codegardener.com•85 days ago

First (really nit picky) but report... Guide should be capitalized.

alan.codegardener.com•85 days ago

Of course, that should have said "bug report" which is hilarious.

excid3.com•85 days ago

As long as they're nits and not huge things I overlooked 😜

drbragg.dev•85 days ago

Did you spell ASCII correctly?

excid3.com•85 days ago

Dying 😭

drbragg.dev•85 days ago

😂😂😂

skillstopractice.com•85 days ago

Dropping just a quick note here... it's excellent that this calls out that most of the guide focuses on the app folder and in practice, most of the time anyone is working in Rails that's where most of the action is.

Could make that even harder to miss by saying that *before* the table.

skillstopractice.com•85 days ago

Something like the following as a possible first line?

"Rails codebases have a lot of folders in them, each with their own specific purpose. Don't worry, most of your work (including much of this guide) happens in the *app* folder, but let's take a quick look at the overall structure"

excid3.com•85 days ago

I like that idea

skillstopractice.com•85 days ago

Nice! I also dropped this into the Ruby + Rails : Distilled Feed so hopefully that'll encourage folks to send more feedback your way.

https://bsky.app/profile/skillstopractice.com/feed/aaaf5jle4pb7e

(This is exactly the kind of stuff I built it for, so it doesn't easily get lost in the noise of the typical "following" timeline )

excid3.com•85 days ago

Oh, great idea. It is so easy to miss important things, I like this a lot.

skillstopractice.com•85 days ago

Even *with* the feeds I've set up to track Ruby related things, it's still like finding needles in haystacks at times.

Anything that's a call for comments on an open source project of note is something I want to capture, so you or anyone else is welcome to DM if I miss it.

skillstopractice.com•85 days ago

Will take a look. Thanks for working on this!

High quality guides are huge part of what make me appreciate Rails. They're often good enough that you don't need to reference API docs much.

excid3.com•85 days ago

Same! API docs can't usually communicate the overall way to use the individual parts so the guides are incredibly valuable.

ianbradbury.micro.blog•85 days ago

Reading the Install Ruby on Rails guide....

I notice that you're recommending Mise over RBENV..... (or other version manger). TBH I'd not heard of Mise until 10 minutes ago. Is this what all the cool young cats are using now? Should I - us all - be planning to move over to Mise?

excid3.com•85 days ago

Yeah it's great. Uses Ruby build underneath and can use asdf plugins. Can also do node and other langs.

One day we will get precompiled rubies and life will be way, way simpler.

ianbradbury.micro.blog•85 days ago

I had a quick glance at the Mise site. That's a lot of features, if only there was a site where I could watch a video.

Anyhow, I think recommending Mise over rbenv or RVM will be confusing to newcomers, especially as the Ruby Language site recommends rbenv or RVM or RubyInstaller for Windows.

excid3.com•85 days ago

I know there's plans to update the Ruby site at some point soon too. Everything needs a fresh coat of paint.

elhalvers.bsky.social•85 days ago

I am enjoying going through it! 🥳

Comments

Posting Rules

Reply