atmos:dsp:workspace
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| atmos:dsp:workspace [2026/01/12 20:06] – [Suggested directory layout] marwa | atmos:dsp:workspace [2026/01/12 21:08] (current) – [Workspace Organization & Structure] marwa | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Workspace Organization & Structure ====== | + | ====== |
| ===== Purpose ===== | ===== Purpose ===== | ||
| - | This page defines the folder organization, | + | Each student has a dedicated workspace to document progress |
| + | * **student/ | ||
| + | * **mentor/** is mentor-only (private notes and drafts) | ||
| ===== Folder structure ===== | ===== Folder structure ===== | ||
| - | Each student has a dedicated folder with two top-level directories: | ||
| - | |||
| - | * **student/ | ||
| - | * **mentor/** → mentor-only notes | ||
| - | |||
| - | ==== Suggested directory layout ==== | ||
| ==== Suggested directory layout ==== | ==== Suggested directory layout ==== | ||
| < | < | ||
| - | / | + | / |
| - | ├── | + | ├── |
| │ | │ | ||
| │ | │ | ||
| Line 22: | Line 18: | ||
| │ | │ | ||
| │ | │ | ||
| - | │ └── README.md | + | │ |
| - | └── | + | └── |
| ├── 00_meeting_notes/ | ├── 00_meeting_notes/ | ||
| - | └── 01_feedback_drafts/ | ||
| </ | </ | ||
| + | ===== What Each Folder is For ? ===== | ||
| - | ===== What goes where ===== | + | ==== Student/ |
| - | ==== student/ (shared) ==== | + | This is the main working space. Everything the student |
| - | * Progress logs, data/model logs | + | |
| - | * Analysis notebooks/ | + | |
| - | * Figures + captions | + | |
| - | * Final report + slides + reproducibility notes | + | |
| - | ==== mentor/ (private by default) ==== | + | === student/ |
| - | * Private mentoring | + | **Purpose: |
| - | * Draft feedback | + | **Put here:** |
| - | * Cleaned | + | * learning plan (goals + skills to practice) |
| + | * work schedule (weekly plan + meeting time) | ||
| + | * project brief (project title, question, scope, success criteria) | ||
| + | * contacts + quick links + access notes (tools/data locations) | ||
| + | * any required forms/ | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * orientation reflections | ||
| + | * career/ | ||
| + | * project interests + initial project selection notes | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * practice notebooks/ | ||
| + | * “how-to” notes (plotting, data cleaning, reading files) | ||
| + | * small exercises and mini-checkpoints | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * raw data notes (where data came from, time ranges, variables) | ||
| + | * configuration/ | ||
| + | * model run notes (if applicable) | ||
| + | * data/model log (what you downloaded/ | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * weekly progress log (weekly) | ||
| + | * analysis notebooks/ | ||
| + | * figures/ (plots + captions) | ||
| + | * intermediate findings and “next steps” notes | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * project plan + milestones | ||
| + | * final analysis notebook/ | ||
| + | * final figure set | ||
| + | * draft report text and draft slides | ||
| + | |||
| + | === student/ | ||
| + | **Purpose: | ||
| + | **Put here:** | ||
| + | * final_report.pdf (or .docx if requested) | ||
| + | * final_slides.pdf (or .pptx) | ||
| + | * reproducibility_readme.md (how to reproduce the results) | ||
| + | * final figures (publication-ready) | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ===== Mentor ===== | ||
| + | This folder is **not for student writing**. It is for mentor-only | ||
| + | |||
| + | === mentor/ | ||
| + | **Purpose: | ||
| + | * meeting date + attendance | ||
| + | * Tasks + notes and follow-up items | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ===== Note-sharing + Notification Rule ===== | ||
| + | Mentor notes are private by default. If the mentor wants to share feedback | ||
| + | | ||
| + | |||
| + | **Student notification requirement** | ||
| + | When a student uploads new items or adds new notes (logs, notebooks, figures, drafts), the student must **email their mentor** the same day (or within 24 hours) to: | ||
| + | * confirm what was added/updated, | ||
| + | | ||
| + | * List any questions or blockers. | ||
| + | |||
| + | ==== Email preparation (student → mentor) ==== | ||
| + | **Subject line (use one of these):** | ||
| + | * Data Skills Pathway – Update (lastname_firstname) – Week X | ||
| + | * Data Skills Pathway – New Uploads (lastname_firstname) – [date] | ||
| + | |||
| + | **Email body (copy/paste template): | ||
| + | < | ||
| + | Hi [Mentor Name], | ||
| + | |||
| + | I uploaded/ | ||
| + | |||
| + | 1) What I added/ | ||
| + | - [short description] — / | ||
| + | - [short description] — / | ||
| + | |||
| + | 2) Key results (1–3 bullets) | ||
| + | - [result/ | ||
| + | - [result/ | ||
| + | |||
| + | 3) Questions / blockers | ||
| + | - [question or blocker] | ||
| + | - [question or blocker] | ||
| + | |||
| + | 4) What I’m doing next (next 1 week) | ||
| + | - [next step] | ||
| + | |||
| + | Thank you, | ||
| + | [Student Name] | ||
| + | </ | ||
| - | ===== Required student documentation ===== | ||
| - | - **Weekly Progress Log (weekly)** | ||
| - | - **Data/ | ||
| - | - **Reproducible scripts/ | ||
| - | - **Final deliverables** (report + slides + complete reproducible folder) | ||
| - | ===== Mentor note-sharing workflow ===== | ||
| - | Mentor notes are private by default. To share feedback: | ||
| - | * Copy a cleaned note into **mentor/ | ||
| - | * (Optional) also place shared feedback in a relevant student folder as: | ||
| - | **feedback_shared_YYYYMMDD.md** | ||
| - | ===== Access control (recommended) ===== | + | [[atmos: |
| - | * student/ → shared access (student + mentor) | + | |
| - | * mentor/ | + | |
| - | (Implementation can be done using Linux group permissions and/or wiki ACLs.) | + | |
| - | ===== Quick links ===== | ||
| - | * [[atmos: | ||
| - | * [[atmos: | ||
| - | * [[atmos: | ||
atmos/dsp/workspace.1768248412.txt.gz · Last modified: 2026/01/12 20:06 by marwa