Skip to content

DOC: Improve flow of '10 minutes to pandas' by adding an intro to the Merge section #63592

@Saikrishna-dev-oss

Description

@Saikrishna-dev-oss

Pandas version checks

  • I have checked that the issue still exists on the latest versions of the docs on main here

Location of the documentation

Image https://pandas.pydata.org/docs/user_guide/10min.html#merge

Documentation problem

When I am going through 10 min pandas guide I noticed something that feels like a gap in the "Merge" section.
Right now, the "Merge" header acts only as a title, but the content immediately jumps into "Concat". For a beginner will expect an pd.merge example to understand the sections namesake. Instead, I had to scroll through "Concat" and "Join" before finding an actual merge operation.

Suggested fix for documentation

I would like to propose adding one or two sentences explaining that "Merge" is a category for several operations (Concat, Join, and Merge) would make the flow easier to understand and adding a simple, self-contained pd.merge example directly under the "Merge" header, before the "Concat" sub-section starts.

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocsNeeds TriageIssue that has not been reviewed by a pandas team member

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions