Skip to content

Glossary is missing 'HEAD' and 'Staging area' #32

Open

Description

@pushpam2404

Context

Git prints both words at people constantly — "HEAD detached at abc123", "Changes not staged for commit" — and never explains either. They are two of the most alarming-looking things a beginner meets.

What to change

Files: data/glossary.json

Requirements:

  • Add one object for HEAD and one for Staging area
  • For HEAD, say plainly that "detached HEAD" is not damage
  • For the staging area, explain what git add actually does
  • Mention the alternative name "index" for the staging area

Acceptance criteria

  • Both terms appear on the glossary page
  • The HEAD entry would reassure somebody who just saw the detached-HEAD message
  • The JSON still parses

How to verify locally

python3 -m http.server 8000

Then open http://localhost:8000.

Difficulty

Beginner.


New here? Comment /claim on this issue and a bot will assign it to you. Then read CONTRIBUTING.md.

Stuck at any point? Comment here saying what you have tried and where it stopped working — that is not an admission of failure, it is how we find out the instructions were unclear. You can also come to a PR Debug Clinic (Oct 12 or Oct 21).

Activity

  1. shreyakar20 commented on Oct 5, 2026

    @shreyakar20

    /claim

  2. github-actions commented on Oct 5, 2026

    @github-actions

    Assigned to @shreyakar20. It is yours.

    Next steps

    1. Fork this repo and clone your fork
    2. git checkout -b fix/short-description
    3. Make the change, commit, push
    4. Open a PR with Closes #32 in the description

    If you get stuck, comment here saying what you have tried. If you change your mind, comment /unclaim — no hard feelings, that is genuinely fine.

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

Metadata

Metadata

Assignees

Labels

difficulty: beginnerNo prior knowledge of the codebase neededdocumentationDocs, README, guidesdomain: os-devxOpen Source & Developer Experiencegood first issueGreat for your very first pull requesthacktoberfestCounts toward Hacktoberfest 2026status: claimedAssigned to a contributor — do not start work on this

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions