rubyapi icon indicating copy to clipboard operation
rubyapi copied to clipboard

Expand classes on homepage

Open p8 opened this issue 3 years ago • 10 comments

Instead of listing 6 classes on the homepage, why not list most of the classes found in the Ruby standard library? This shows beginners and experienced developers what is available, and lets them discover lesser known classes.

image

@colby-swandale This is just a quick proof-of-concept. You can close this if you don't like this or want a completely different implementation. And thanks creating rubyapi :)

p8 avatar Jul 07 '21 19:07 p8

I personally think this is really cool. I've been doing Ruby/Rails development for almost 10 years, and seeing some of the classes listed gives me inspiration on things to learn about.

natematykiewicz avatar Jul 10 '21 20:07 natematykiewicz

👋 I really like this idea! Some of my quick & immediate thoughts:

  • I like the list currently, but I think adding some spacing & UI elements would help make it more readable for everyone. Think adding in padding, hover states, etc.
  • Not sure about the Modules section. It feels like it's standing out from everything else. Maybe it could be swapped out for something relating to advanced objects like XML, JSON, YAML?

colby-swandale avatar Jul 12 '21 13:07 colby-swandale

Thanks for the feedback! I'll see if I can make some changes.

p8 avatar Jul 12 '21 16:07 p8

Hey @p8 👋 are you still working on this? I think this would be a great change to merge. Is there any assistance I can offer?

colby-swandale avatar Nov 25 '21 11:11 colby-swandale

Hey @colby-swandale, yes hopefully I can make some changes soon.

p8 avatar Dec 24 '21 13:12 p8

This is a really cool idea @p8. Do you need any help getting this ready to merge?

olivierlacan avatar Dec 10 '22 08:12 olivierlacan

Thanks @olivierlacan. I've expanded the descriptions to be more textual. I can imagine this might be a bit too opinionated for some... I'm not yet satisfied with the layout (I'm not that handy with Tailwind and Slim 😄 ). I think the links should be a bit more subtle. image

p8 avatar Dec 13 '22 18:12 p8

I'm really liking the direction this is taking! It greatly expands on the broader things available in Ruby while keeping the page simple and easy to understand.

This could be a good opportunity to tinker with the homepage a bit, I'm keen to hear on any ideas to make the homepage more intuitive and easier to understand for various users (but not a requirement for this PR). Any examples also welcome!

colby-swandale avatar Dec 15 '22 11:12 colby-swandale

@colby-swandale I do wonder if there's an opportunity to use the AnywayConfig + DRY Struct combo here as well. Not that it's a requirement of Petrik's PR by any means, but it could be nice to have a very consistent layout between boxes by forcing them all to conform a basic format.

@p8 I know you mentioned Slim. Colby removed Slim a little while ago. Your branch is quite out of date (sorry that this has taken so long...), but if you rebase to main, the whole site is .html.erb now.

natematykiewicz avatar Dec 15 '22 16:12 natematykiewicz

Thanks everyone! I'll try to rebase everything to main.

p8 avatar Dec 15 '22 18:12 p8