Skip to content

Conversation

@k0kubun
Copy link
Member

@k0kubun k0kubun commented Nov 19, 2022

Partly address this problem #449 (comment):

How can we help users discover them? debug has help command to help users learn all the commands' usages. But irb doesn't have it and we also don't have good documentation atm.

With the current way of README format, I haven't noticed IRB had a long document at https://docs.ruby-lang.org/en/master/IRB.html until today. I find it more discoverable to just write them down in README like debug.gem https://github.com/ruby/debug#debug-command-on-the-debug-console.

So, while I added the list to the official documentation for its readers, I also added it to the README as well. This should be useful even after #450 since you'll somehow need to discover help command itself. Having that in README could be a good help.

Note that this list is based on this comment. I think we could document this even better, e.g. have categories or show commonly-used commands first, but that shouldn't stop this PR from being merged. I'd like to focus on having something first, and then improve it in other PRs.

@k0kubun k0kubun requested a review from st0012 November 19, 2022 08:28
Copy link
Member

@st0012 st0012 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice 👍

I think after #450 we can make a readme template like debug's and just generate them automatically.

@k0kubun k0kubun merged commit f7fb7ca into ruby:master Nov 19, 2022
@k0kubun k0kubun deleted the commands-readme branch November 19, 2022 22:14
matzbot pushed a commit to ruby/ruby that referenced this pull request Nov 19, 2022
(ruby/irb#451)

* Document a full list of commands

* Document debug as well

* Make it less duplicated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants