Skip to content

docs: added formatted README with screenshots and improved structure (issue #8) - #11

Open
anjanakri wants to merge 5 commits into
jaideep005:mainfrom
anjanakri:main
Open

docs: added formatted README with screenshots and improved structure (issue #8)#11
anjanakri wants to merge 5 commits into
jaideep005:mainfrom
anjanakri:main

Conversation

@anjanakri

@anjanakri anjanakri commented May 26, 2026

Copy link
Copy Markdown

📝 Summary

Restructured and formatted the README.md for improved readability, consistency, and visual appeal. Added project screenshots and enhanced documentation clarity.

Fixes/Related Issue

Fixes #8

🎯 Changes Made

Structure & Formatting

  • ✅ Reorganized README with consistent heading hierarchy (H1 → H2 → H3)
  • ✅ Added Table of Contents with anchor links for easy navigation
  • ✅ Standardized formatting across all sections (removed mixed symbols like >>, ->, 🔹)

Visual Enhancements

  • ✅ Added GitHub badges (Ethereum, React, Spring Boot, IPFS, Vercel)
  • ✅ Included ASCII architecture diagram for clarity
  • ✅ Enhanced tech stack section with categorized badge display
  • ✅ Added project screenshots (homepage and dashboard UI)

Content Improvements

  • ✅ Clarified project description with problem-solution table
  • ✅ Improved workflow explanation with step-by-step numbering
  • ✅ Enhanced deployment section with component-platform mapping
  • ✅ Added comparison table: OrganChain vs Traditional Systems
  • ✅ Updated contributing guidelines with Git commands

Files Changed

  • README.md — Complete restructure and enhancement
  • screenshot_homepage.png — Platform landing page (NEW)
  • screenshot_dashboard.png — Admin dashboard interface (NEW)

🔍 Why This Matters

  • First Impression: A well-formatted README is the first thing developers see
  • Discoverability: Better navigation helps contributors find info quickly
  • Professionalism: Consistent styling shows project maturity
  • Engagement: Screenshots showcase the platform's UI/UX

✅ Testing

  • README renders correctly on GitHub
  • All internal links work (if viewing locally)
  • Screenshots display properly
  • No broken formatting or syntax errors

📋 Checklist

  • README structure is consistent throughout
  • Screenshots are included and properly referenced
  • All links are valid
  • No spelling/grammar errors
  • Follows GitHub best practices

##Screenshots

image image

Copilot AI review requested due to automatic review settings May 26, 2026 07:51
@anjanakri anjanakri changed the title docs: added formatted README with screenshots and improved structure docs: added formatted README with screenshots and improved structure (issue #8) May 26, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the README to be more structured and informative, with clearer sections for architecture, tech stack, workflow, setup, and contribution guidance.

Changes:

  • Reformatted the README with consistent Markdown headings, separators, and a new Table of Contents.
  • Replaced narrative tech stack sections with purpose-driven tables and clarified workflow steps.
  • Added screenshots and expanded setup/deployment/contributing instructions.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment on lines +70 to +73
| Technology | Purpose |
|------------|---------|
| React.js | Fast UI rendering and seamless Web3 integration |
| Vercel | Serverless, scalable hosting |
Comment thread README.md
Comment on lines +132 to +139
![OrganChain Homepage](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/landing-page.png)

---

### Admin Dashboard
*Platform dashboard for managing donors, patients, pledges, and transplant matching*

![OrganChain Dashboard](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/dashboard.png)
Comment thread README.md
Comment on lines +132 to +139
![OrganChain Homepage](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/landing-page.png)

---

### Admin Dashboard
*Platform dashboard for managing donors, patients, pledges, and transplant matching*

![OrganChain Dashboard](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/dashboard.png)
Comment thread README.md Outdated
Comment thread README.md
- Ganache
- MetaMask browser extension

### Clone the Repository
Comment thread README.md Outdated

---

## Screenshots
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@anjanakri
anjanakri marked this pull request as draft May 27, 2026 10:40
Updated language for clarity and consistency throughout the README. Added sections on project features, setup instructions, and future scope.
@anjanakri
anjanakri requested a review from Copilot May 27, 2026 15:57

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 8 comments.

Comment thread README.md
Comment on lines +78 to +81
| Technology | Purpose |
|------------|---------|
| React.js | Fast and responsive user interface |
| Vercel | Scalable frontend hosting |
Comment thread README.md
*Public-facing landing page with organ donation awareness and pledge CTA*

* Smart contract stores:
![OrganChain Homepage](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/landing-page.png)
Comment thread README.md

* Fetch CID from blockchain
* Retrieve file from IPFS securely
![OrganChain Dashboard](Desktop/organchain-main/organchain-main/Version_1_Frontend/src/screenshots/dashboard.png)
Comment thread README.md
- [Comparison with Traditional Systems](#comparison-with-traditional-systems)
- [Limitations](#limitations)
- [Future Scope](#future-scope)
- [Contributing](#contributing)
Comment thread README.md
Comment on lines +253 to +255
## Environment Variables

Create a `.env` file where required.
Comment thread README.md Outdated
Comment thread README.md
```
organchain/
```text
Organ_BlockChain/
Comment thread README.md
```bash
git clone https://github.com/ffrazi/organchain.git
cd organchain
git clone https://github.com/jaideep005/Organ_BlockChain.git
@anjanakri

Copy link
Copy Markdown
Author

Hey Admin @jaideep005, kindly review this PR. This PR fixes issue #8 that you assigned.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@jaideep005
jaideep005 marked this pull request as ready for review June 2, 2026 04:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve README.md structure and formatting consistency

3 participants