From da0b7ab8521a998daeb4d82be584b14504653c17 Mon Sep 17 00:00:00 2001
From: Bhoomi Sharma <bhoomi3100@gmail.com>
Date: Fri, 31 Oct 2025 23:00:32 +0530
Subject: [PATCH] Enhance README with contribution and setup instructions

Expanded README to include contribution guidelines, local development setup, and project technology details.
---
 README.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 62 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 1aa2128..b27e2f3 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,67 @@
-# Creative Computing Society
-The repository for the Creative Computing Society's Hacktoberfest website. 
+# Creative Computing Society Hacktoberfest Website
 
-Website can be found at: https://creative-computing-society.github.io
+This repository hosts the Hacktoberfest contribution website for the **Creative Computing Society** (CCS), built upon the popular **Start Bootstrap - Creative** theme. This project is intended to be a **beginner-friendly** starting point for anyone looking to make their first open-source contribution!
 
+---
 
-For an extensive beginner's guide on how to make a pull request, kindly visit 
-https://github.com/creative-computing-society/Guide_to_contribute_in_Hacktoberfest
+## 🌟 Hacktoberfest Contribution Guide
 
-Also you can try and learn working with github more on try.github.io !
+We warmly welcome contributions from everyone! If you're new to open source, this is the perfect place to start.
 
-## Optional commands
-// Set up Intructions if you want to run broswersync, scss ect. ---
-1. Clone Repo
-2. inside directory root, run - npm install (in terminal)
-3. Run in terminal - gulp dev (will fire up localhost server so you view the site and edit)
+### Quick Start: Fix a Typo (Easiest PR)
+
+1.  **Fork** this repository.
+2.  Navigate to a file (like `index.html` or this `README.md`) and click the **pencil icon** to edit it directly on GitHub.
+3.  Fix a typo or improve the wording of a sentence.
+4.  Commit your change with a clear message (e.g., `Fix: Clarified instructions in README`).
+5.  Open a **Pull Request (PR)** from your fork back to this repository.
+
+### For More Detailed Guidance:
+
+For a comprehensive walkthrough on the Git/GitHub workflow (Fork $\rightarrow$ Clone $\rightarrow$ Edit $\rightarrow$ PR), please visit our dedicated guide:
+
+👉 [CCS Guide to Contributing in Hacktoberfest](https://github.com/creative-computing-society/Guide_to_contribute_in_Hacktoberfest)
+
+---
+
+## 🛠️ Local Development Setup
+
+If you wish to run the website locally and test more complex changes (like CSS or JavaScript updates), follow these steps:
+
+This project uses **[Gulp](http://gulpjs.com/)** to compile SASS/SCSS files and **[BrowserSync](https://browsersync.io/)** for live-reloading.
+
+### Prerequisites
+
+You must have **Node.js** and **npm** (Node Package Manager) installed on your system.
+
+### Installation & Run
+
+1.  **Clone the Repository:**
+    ```bash
+    git clone [https://github.com/creative-computing-society/creative-computing-society.github.io.git](https://github.com/creative-computing-society/creative-computing-society.github.io.git)
+    ```
+2.  **Install Dependencies:** Navigate into the directory and install the necessary packages.
+    ```bash
+    cd creative-computing-society.github.io
+    npm install
+    ```
+3.  **Start Local Server:** Run the development command.
+    ```bash
+    gulp dev
+    ```
+    This command will open the site in your browser at `http://localhost:3000` (or similar) and watch your files for changes.
+
+---
+
+## 📚 Project Technology
+
+This theme is based on the following key libraries, as listed in the `package.json`:
+
+* **Frontend Framework:** Bootstrap (v4.1.3)
+* **Icons:** Font Awesome (v5.3.1)
+* **Scrolling Effects:** ScrollReveal, jQuery Easing
+* **Image Gallery:** Magnific Popup
+
+### License
+
+This project is licensed under the **MIT License**.