Skip to content

[Document Request] Add a migration guide for byebug users #644

@st0012

Description

@st0012

What

  1. Add a document docs/migrate_from_byebug.md as the migration guide for byebug users.
  2. Add a link to it in the readme

Content

  • It should list command comparisons, especially around step debugging, to help users learn what's changed or not changed.
    • Preferably using markdown table for this instead of a separate page to optimize reader's experience.
  • It should also emphasize the features that're unique to the debugger as an attraction.

Why

Based on the latest Rails community survey, byebug has 30% of the market share vs debugger's 10%. Given that byebug and the debugger share the same user base, a migration guide should help speed up the adoption.

Screenshot 2022-05-25 at 14 56 46

Additional context

  • I know there's already a debug command comparison sheet. It'll be a nice supporting material but it's not specific for byebug. So I think it can't replace the migration guide I mentioned above.
  • If there's no objection on this idea, I'll work on it.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions