Skip to content

Added detailed README with features and setup#11

Open
adityak-06 wants to merge 4 commits intocodepvg:mainfrom
adityak-06:akwork1
Open

Added detailed README with features and setup#11
adityak-06 wants to merge 4 commits intocodepvg:mainfrom
adityak-06:akwork1

Conversation

@adityak-06
Copy link
Copy Markdown

@adityak-06 adityak-06 commented Apr 1, 2026

📄 README Enhancement

This PR adds a detailed and structured README.md to improve project understanding for new users and contributors.

✨ Changes Made

  • Added project overview and purpose
  • Documented key features of the platform
  • Included clear steps to run the project locally
  • Explained project structure
  • Added contribution guidelines

🎯 Impact

  • Makes the repository more beginner-friendly
  • Improves onboarding for new contributors
  • Provides clear documentation for setup and usage

Closes #5

Copy link
Copy Markdown
Collaborator

@jagdish-15 jagdish-15 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for taking this up. Here are a few suggested changes:

Comment thread README.md Outdated

---

## Features
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let’s avoid including a features section in the README, so we don’t have to keep updating it every time new features are added.

Comment thread README.md Outdated
Comment thread README.md Outdated

---

## Tech Stack
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already get a summary of the tech stack on the main repo page, so instead of repeating that in the README, we can link the related repos for the backend and the web scraping API (since LeetCode doesn’t officially provide one):

This would be more useful and avoid redundancy

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment on lines +86 to +89

npm install
cd frontend
npm install
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
npm install
cd frontend
npm install
`npm install`

Comment thread README.md
Copy link
Copy Markdown
Collaborator

@jagdish-15 jagdish-15 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you please make these few changes before we merge this

Comment thread README.md
Comment on lines +44 to +45
### 1. Clone the repository

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### 1. Clone the repository
### 1. Fork and clone the repository
First, fork the repository to your GitHub account. Then clone it locally:

Comment thread README.md
Comment on lines +54 to +55
cd frontend
`npm install`
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
cd frontend
`npm install`

Comment thread README.md
Comment on lines +59 to +64

`npm run dev`

or

node server.js
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
`npm run dev`
or
node server.js
`npm run dev`
or
`node start`

Comment thread README.md
Comment on lines +71 to +72
4. View your ranking on the leaderboard after
the next sync
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. View your ranking on the leaderboard after
the next sync
4. View your ranking on the leaderboard after the next sync

Comment thread README.md
Comment on lines +18 to +26

This project relies on external services for fetching and processing LeetCode data.
Instead of duplicating details here, refer to the following repositories:

- [leetcode-api](https://github.com/codepvg/leetcode-api) – API used to fetch user data from LeetCode
- [lc-backend](https://github.com/codepvg/lc-backend) – Backend service for storing and managing leaderboard data

These repositories handle the core data processing and integration logic for the leaderboard.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This project relies on external services for fetching and processing LeetCode data.
Instead of duplicating details here, refer to the following repositories:
- [leetcode-api](https://github.com/codepvg/leetcode-api) – API used to fetch user data from LeetCode
- [lc-backend](https://github.com/codepvg/lc-backend) – Backend service for storing and managing leaderboard data
These repositories handle the core data processing and integration logic for the leaderboard.
## Related Repositories
This project relies on external services for fetching and processing LeetCode data.
Instead of duplicating details here, refer to the following repositories:
- [leetcode-api](https://github.com/codepvg/leetcode-api) – API used to fetch user data from LeetCode
- [lc-backend](https://github.com/codepvg/lc-backend) – Backend service for storing and managing leaderboard data
- [frontend-uptime-monitor](https://github.com/codepvg/frontend-uptime-monitor) – Pinger service to monitor frontend server uptime
- [backend-uptime-monitor](https://github.com/codepvg/backend-uptime-monitor) – Pinger service to monitor backend server uptime
These repositories handle the core data processing and integration logic for the leaderboard.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a proper README.md

2 participants