First pass at updating en/documentation/index.md #3427
Conversation
LOTS of bitrot on this page. Most has been removed but some have been moved down to an "older" section.
zenspider
force-pushed
the
zenspider/update_docs
branch
from
cbaea65
to
bb2fea0
Compare
|
From my (new to Ruby) perspective, this looks like a massive improvement. Having just completed the Ruby Koans, I can confirm that they are still correct for Ruby 3.3. |
en/documentation/index.md
Outdated
| [The Well-Grounded Rubyist][grounded] | ||
| : A tutorial that begins with your first Ruby program and takes you all the way to sophisticated topics like reflection, threading, and recursion. | ||
|
|
||
| #### Adept |
There was a problem hiding this comment.
As a non-native English speaker, I think Adept is a relatively rare choice of word. Maybe Advanced will be more approachable?
There was a problem hiding this comment.
Maybe Experienced would be better? Advanced and Expert are closer in my mind than Adept/Experienced and Expert are.
| * Expert | ||
| * [Emacs][20] with [Ruby mode][21] or [Enhanced Ruby mode][enh-ruby-mode] | ||
| * [Vim][25] with [vim-ruby][26] plugin | ||
| * [NeoVim][neovim] |
There was a problem hiding this comment.
I'm not sure if we need or should pair editors with experience levels. For example, I started writing Ruby with Vim, then switched to NeoVim for like 6 years, and switched to VS Code like 2 years ago.
There was a problem hiding this comment.
I think the idea is from an approachability standpoint instead of an end user skill level standpoint.
There was a problem hiding this comment.
yeah, I meant this more about learning curve of the editor
en/documentation/index.md
Outdated
| All of these editors support the Language Server Protocol (LSP). You | ||
| can use Shopify's [ruby-lsp][ruby-lsp] plugin for ruby support. |
There was a problem hiding this comment.
| All of these editors support the Language Server Protocol (LSP). You | |
| can use Shopify's [ruby-lsp][ruby-lsp] plugin for ruby support. | |
| All of these editors support the Language Server Protocol (LSP), either by default or through their LSP plugins. | |
| Shopify's [ruby-lsp][ruby-lsp] is one of the most popular language servers for Ruby and [supports all of the above editors](https://shopify.github.io/ruby-lsp/editors.html) |
|
Pushed some edits based on feedback. Please let me squash and reword before merge (assuming). |
main changes:
LOTS of bitrot on this page. Most has been removed but some have been
moved down to an "older" section.
Revamped editor section to include difficulty "levels"
Added a bunch of sections and links mostly derived from the ruby
discord's #library.
This fixes #3426