Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document a full list of commands #451

Merged
merged 3 commits into from
Nov 19, 2022
Merged

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.

README.md Show resolved Hide resolved
@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
Development

Successfully merging this pull request may close these issues.

2 participants