# 🚀 Getting Started with the SBCCAS Ecosystem

> **New Student? Welcome!**  
> This guide is your onboarding manual to understanding GitHub, finding your college subjects, running lab code, and building your digital portfolio.

---

## 1. What is GitHub?
Think of **GitHub** as the global digital workshop for developers. While Google Drive or USB drives store static files, GitHub tracks **code as it evolves**, remembers every version, lets developers collaborate across the globe, and showcases what you can actually build to future employers.

---

## 2. What is the `sbccas` Organization?
**sbccas** is the official GitHub organization of **Sutex Bank College of Computer Applications and Science (Amroli College)**.

Instead of circulating code snippets on WhatsApp or lost paper manuals, faculty and mentors maintain repositories containing:
* Official syllabus-aligned lab practicals
* Step-by-step code demonstrations
* Jupyter and Google Colab notebooks for AI and Data Science
* Capstone projects and student assignment references

---

## 3. How to Find Your Subject
1. **Browse the Catalog:** Visit the [Repository Catalog](../data/repositories.json) or explore our [Learning Paths](./learning-paths/).
2. **Filter by Program:** Look for repositories tagged with your degree:
   * **BCA:** Fundamentals in C, Operating Systems, Python, ASP.NET, Android (MAD), and VB.NET.
   * **B.Sc. Data Science & Analytics:** Big Data (DS-505), PySpark, and Machine Learning pipelines.
   * **B.Sc. IT:** Programming fundamentals in C and Systems.
3. **Use the Search Bar:** On the [SBCCAS Organization Page](https://github.com/sbccas), type your course code or topic into the repository search bar (e.g., `104-CPPM`, `204`, `305`, `python`, `pyspark`).

---

## 4. How to Access and Run the Code

You have three beginner-friendly ways to access code from any repository:

### Method A: Direct Browser Reading
* Simply click into any folder or file (e.g., `main.c`, `script.py`, or `README.md`) on GitHub to read the syntax-highlighted code directly.

### Method B: Download as ZIP (Quick Offline Access)
1. On the repository page, click the green **`<> Code`** button near the top right.
2. Select **`Download ZIP`**.
3. Extract the ZIP folder on your local computer to run the code in your local editor (VS Code, Turbo C++, or Python IDLE).

### Method C: Clone with Git (The Modern Developer Way)
If you have Git installed on your computer:
```bash
# Clone the repository to your local machine
git clone https://github.com/sbccas/<repository-name>.git

# Enter the project directory
cd <repository-name>
```

---

## 5. Working with Interactive Notebooks (Google Colab & Jupyter)
For Data Science and AI repositories (like `Big-Data-Handling-and-Management-for-Machine-Learning-Applications` or `data-analytics-using-python`):
1. **Jupyter Notebooks (`.ipynb` files):** GitHub natively previews notebook outputs, equations, and charts right in your browser.
2. **Running in Google Colab:**
   * Go to [colab.research.google.com](https://colab.research.google.com).
   * Click the **GitHub** tab.
   * Enter `sbccas` as the organization and choose the repository and notebook.
   * You can now run, edit, and experiment with Python and GPU-accelerated code directly in the cloud without installing heavy software locally!

---

## 6. How AI Tools Can Assist Your Learning
Artificial Intelligence (ChatGPT, Claude, Gemini, GitHub Copilot) is a supercharger when used properly:
* ✅ **Use AI to explain code line-by-line:** *"Can you explain how this pointer arithmetic works in 104-CPPM C code?"*
* ✅ **Use AI to debug compiler errors:** *"Here is my compiler error message and my code snippet. What logical condition did I miss?"*
* ❌ **Never copy-paste blindly without understanding:** Submitting code you cannot explain during a viva or practical exam defeats the purpose of your degree.

Read our complete [AI-Era Learning Guide](./AI_ERA_LEARNING.md) for best practices and academic integrity rules.

---

## 7. Next Steps: Build Your Own Portfolio
1. **Create your personal GitHub account.**
2. **Star** the college repositories you reference to bookmark them.
3. **Fork** a project or assignment repository to your own account.
4. **Modify the code:** Change parameters, add new features, fix bugs, and commit your improvements.
5. In your resume, link your GitHub profile as proof of your real-world coding ability!