@Ryanbigg I more or less agree with this, but I think step 1 is making the API documentation more prominent relative to everything else. (And dropping the link to version one of the pickaxe book, which is 20 years out of date)

3
Share
Share on Mastodon
Share on Twitter
Share on Facebook
Share on Linkedin
Ryan Bigg

@noelrap that one includes such gems as:

The Ruby developers use CVS (Concurrent Version System, freely available from cvshome.com) as their revision control system. You can check files out as an anonymous user…

I agree that it should be updated to your new edition!!

1
10mo
PointlessOne

@noelrap @Ryanbigg Yeah, the page certainly can use a review. RSense had last release almost 10 years ago, for one. For reference, it’s when Ruby 2.2 was the latest.

0
10mo
PointlessOne

@noelrap @Ryanbigg It'd be nice if someone redesigned the API docs, too. I mean, even just visually it feels a little bit 200x. Even just adopting Yard's default template would bump it up a decade.

0
10mo
Replies