Improve CONTRIBUTING.md for Web-dev-mini-projects

Open Beginner friendly
#950 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
css, html, javascript

Research direction

Start by reading CONTRIBUTING.md and compare its current guidance with the requested beginner workflow. Done means adding the sample index.html, style.css, script.js, and README.md structure, branch and PR examples, and the Fork → Clone → Add Project → Test → Commit → Push → PR checklist; visuals are optional.

Written by the indexing model from the issue text.

Description

LGMSOC21

The current CONTRIBUTING.md explains how to contribute, but it could benefit from examples and a step-by-step checklist for beginners.

Suggestions

  1. Add a sample project folder structure

    • Include index.html, style.css, script.js, and README.md.
  2. Clarify branch naming and PR process

    • Give an example branch name and a simple PR title template.
  3. Add a checklist for first-time contributors

    • Fork → Clone → Add Project → Test → Commit → Push → PR
  4. Optional: Visuals

    • Screenshots or GIFs can guide beginners on how to structure files.

Improving the CONTRIBUTING.md will make it easier for new contributors to follow and increase engagement.


Dominant language
HTML
Stars
4.5k
Forks
1.7k
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Ayushparikh-code/Web-dev-mini-projects

All issues in Ayushparikh-code/Web-dev-mini-projects

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.