init

README.md

@@ -0,0 +1,76 @@
+# Data Visualization Portfolio - Quick Start Guide
+
+This is a quick-start guide to help you get started with the portfolio template.
+
+**📖 For complete requirements, grading rubric, and detailed instructions, see `ASSIGNMENT.md`**
+
+## 📋 Quick Overview
+
+**What to submit by Week 8:**
+- ZIP archive with `index.html`, datasets, and AI documentation (if applicable)
+- 5-7 minute video presentation (link embedded in your portfolio)
+
+**What to create:**
+- Portfolio with minimum 5 visualizations exploring a unified theme
+- Each visualization needs context, design rationale, insights, and source citation
+
+**File naming:** `Portfolio_[LastName]_[FirstName].zip`
+
+---
+
+## 🚀 Quick Start (3 Steps)
+
+### Step 1: Get the Template
+- Download or clone this repository to your computer
+- Open the folder in VS Code (or your preferred editor)
+
+### Step 2: Edit `index.html`
+- Replace all `[placeholders]` with your content
+- Add your visualizations (examples for Vega-Lite, Tableau, and images included)
+- Test by opening `index.html` in your browser
+
+### Step 3: Submit
+- Create ZIP: `Portfolio_[LastName]_[FirstName].zip`
+- Include: `index.html`, all datasets, AI documentation (if applicable)
+- Submit by Week 8
+
+---
+
+## 💡 How to Use the Template
+
+### Adding Visualizations
+
+The template includes **3 examples** you can copy:
+
+1. **Vega-Lite:** Find `<script>` with `var spec1 = {...}`, replace with your spec
+2. **Tableau Public:** Publish to YOUR account, get embed code, paste into HTML
+3. **Python/R/Images:** Export as PNG/SVG, save in same folder, use `<img>` tag
+
+**Add more:** Copy an entire `<article>` block and modify it
+
+### What to Include for Each Visualization
+
+The template has placeholders for:
+- **Context & Question:** What are you exploring and why?
+- **Design Decisions:** Why this chart type? What encodings? What tradeoffs?
+- **Key Insights:** What did you discover?
+- **Data Source:** Where is the data from? (include link)
+
+**See `ASSIGNMENT.md` for detailed requirements and the visualization quality checklist**
+
+---
+
+## 🆘 Need Help?
+
+### Get Support
+**Oleh Omelchenko**
+- Slack (preferred for quick questions)
+- Office Hours: Wednesday 16:00-18:00, KSE Campus
+- Email: o_omelchenko@kse.org.ua
+
+---
+
+## 📚 Additional Resources
+
+- **`ASSIGNMENT.md`** - Complete requirements, grading rubric, and policies
+- **`PUBLISHING.md`** - Optional guide for publishing to GitHub Pages (not graded)