User Tools

Site Tools


atmos:dsp:workspace

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
atmos:dsp:workspace [2026/01/12 20:06] – [Suggested directory layout] marwaatmos:dsp:workspace [2026/01/12 21:08] (current) – [Workspace Organization & Structure] marwa
Line 1: Line 1:
-====== Workspace Organization & Structure ======+====== The Student- Mentor Workspace Organization & Structure ======
  
 ===== Purpose ===== ===== Purpose =====
-This page defines the folder organization, documentation templates, and how mentors and students collaborate using shared and private spaces.+Each student has a dedicated workspace to document progress and deliverables. 
 +  * **student/** is shared (student + mentor) 
 +  * **mentor/** is mentor-only (private notes and drafts)
  
 ===== Folder structure ===== ===== Folder structure =====
-Each student has a dedicated folder with two top-level directories: 
- 
-  * **student/** → shared student↔mentor workspace (deliverables live here) 
-  * **mentor/** → mentor-only notes  
- 
-==== Suggested directory layout ==== 
 ==== Suggested directory layout ==== ==== Suggested directory layout ====
 <code> <code>
-/Data_Skills_Pathway/studentlastname_firstname+/Data_Skills_Pathway/students/lastname_firstname
-├── Student/+├── student/
 │   ├── 00_admin/ │   ├── 00_admin/
 │   ├── 01_orientation/ │   ├── 01_orientation/
Line 22: Line 18:
 │   ├── 05_capstone_project/ │   ├── 05_capstone_project/
 │   ├── 06_deliverables/ │   ├── 06_deliverables/
-│   └── README.md +│   
-└── Mentor/+└── mentor/
     ├── 00_meeting_notes/     ├── 00_meeting_notes/
-    └── 01_feedback_drafts/ 
 </code> </code>
  
 +===== What Each Folder is For ?  =====
  
-===== What goes where ===== +==== Student/ ==== 
-==== student/ (shared) ==== +This is the main working space. Everything the student produces should be documented in this workspace. This workspace will be shared between the student and mentor.  
-  * Progress logs, data/model logs +
-  * Analysis notebooks/scripts +
-  * Figures + captions +
-  * Final report + slides + reproducibility notes+
  
-==== mentor/ (private by default) ==== +=== student/00_admin/ === 
-  * Private mentoring notes and evaluation notes +**Purpose:** setup + planning + project organization. 
-  * Draft feedback +**Put here:** 
-  * Cleaned feedback copied into **02_share_with_student_dropbox/** when appropriate+  * 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/templates 
 + 
 +=== student/01_orientation/ === 
 +**Purpose:** Week 1–2 orientation products. 
 +**Put here:** 
 +  * orientation reflections 
 +  * career/skills goal notes 
 +  * project interests + initial project selection notes 
 + 
 +=== student/02_tools_workshop/ === 
 +**Purpose:** Week 3–4 training outputs. 
 +**Put here:** 
 +  * practice notebooks/scripts 
 +  * “how-to” notes (plotting, data cleaning, reading files) 
 +  * small exercises and mini-checkpoints 
 + 
 +=== student/03_data_collection_or_modeling/ === 
 +**Purpose:** Week 5–10 data intake and/or model output preparation. 
 +**Put here:** 
 +  * raw data notes (where data came from, time ranges, variables) 
 +  * configuration/metadata notes 
 +  * model run notes (if applicable) 
 +  * data/model log (what you downloaded/processed and why) 
 + 
 +=== student/04_guided_analysis/ === 
 +**Purpose:** Week 5–10 analysis with mentor guidance. 
 +**Put here:** 
 +  * weekly progress log (weekly) 
 +  * analysis notebooks/scripts used for figures/results 
 +  * figures/ (plots + captions) 
 +  * intermediate findings and “next steps” notes 
 + 
 +=== student/05_capstone_project/ === 
 +**Purpose:** Week 11–15 capstone mini-project build. 
 +**Put here:** 
 +  * project plan + milestones 
 +  * final analysis notebook/script versions 
 +  * final figure set 
 +  * draft report text and draft slides 
 + 
 +=== student/06_deliverables/ === 
 +**Purpose:** final submission package (clean and complete). 
 +**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 notes and drafts. The mentor can share his notes with the student (when needed). 
 + 
 +=== mentor/00_meeting_notes/ === 
 +**Purpose:** internal meeting records: 
 +  * 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 with a student, the mentor will place a cleaned version inside the mentor workspace and use a clear filename such as: 
 +  * **feedback_shared_YYYYMMDD.md** 
 + 
 +**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, 
 +  provide the **exact path** to the new files, and 
 +  * 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):** 
 +<code> 
 +Hi [Mentor Name], 
 + 
 +I uploaded/updated new items in my Data Skills Pathway workspace. Paths are below: 
 + 
 +1) What I added/updated (with paths) 
 +- [short description] — /Data_Skills_Pathway/students/lastname_firstname/student/[folder]/[filename] 
 +- [short description] — /Data_Skills_Pathway/students/lastname_firstname/student/[folder]/[filename] 
 + 
 +2) Key results (1–3 bullets) 
 +- [result/figure summary] 
 +- [result/figure summary] 
 + 
 +3) Questions / blockers 
 +- [question or blocker] 
 +- [question or blocker] 
 + 
 +4) What I’m doing next (next 1 week) 
 +- [next step] 
 + 
 +Thank you, 
 +[Student Name] 
 +</code>
  
-===== Required student documentation ===== 
-  - **Weekly Progress Log (weekly)** 
-  - **Data/Model Log (ongoing)** 
-  - **Reproducible scripts/notebooks + labeled figures** 
-  - **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/02_share_with_student_dropbox/** 
-  * (Optional) also place shared feedback in a relevant student folder as: 
-    **feedback_shared_YYYYMMDD.md** 
  
-===== Access control (recommended) ===== +[[atmos:data_skills_pathway:home|← Return to Data Skills Pathway Home]]
-  * student/ → shared access (student + mentor) +
-  * mentor/  → mentor-only access +
-(Implementation can be done using Linux group permissions and/or wiki ACLs.)+
  
-===== Quick links ===== 
-  * [[atmos:dsp:projects|Project Menu]] 
-  * [[atmos:dsp:mentor_guide|Mentor Guide]] 
-  * [[atmos:dsp:student_expectations|Student Expectations]] 
  
atmos/dsp/workspace.1768248412.txt.gz · Last modified: 2026/01/12 20:06 by marwa