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

[Documentation] Add one markdown file (.md) showing (1) the API of Readline and (2) the API of Reline #772

Open
rubyFeedback opened this issue Oct 24, 2024 · 0 comments

Comments

@rubyFeedback
Copy link

Would it be possible to add one .md markdown file,
that is like a table layout?

On the left side, there should be the old Readline API.

On the right side, there should be the new Reline API.

Ideally both should be up-to-date.

This file could be put under https://github.com/ruby/reline/tree/master/doc
or doc/reline there. The name could be "API-table" or "API_comparison_table.md"
or something like that.

It does not have to be complete; it can be kept as a partial helper, just showing
the more important API changes (if any).

For instance:

Reline.readmultiline

Specifically, that .md file could also include some helpful advice, and also notices
which methods haven't been ported yet, or which may behave differently.

At any rate, thanks for reading this issue request. I am currently porting some
old Readline code, over to Reline, and the documentation can ideally be improved
for Reline, so that we poor souls can all abandon Readline eventually.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

1 participant