🚧 Under construction — VoTechWorks is being built. A free tech program — complimentary, as our commitment to get America working.
voTechWorksGrade 13 · a vocational technology learning center, by urbanicity
newSchoolWorks.com › VoTechWorks › Technology & Design › Data Science & Analytics › Universal Core: Safety, Math, Communication & Career for Data Science & Analytics › Lesson 6
TEC-DATA85-01 · Lesson 6 · 22 clock hours · lab

Digital Workplace Tools: File Systems, Version Control Concepts, Cloud Storage, and Productivity Suites

Objective. Learners will organize a multi-file data project using a standard folder convention, perform basic Git version-control operations (init, add, commit, push), and demonstrate proficiency with cloud storage and collaboration features of at least one productivity suite.

⚠ Pending professional review

This lesson, its worked examples and its practice questions has not yet been verified by an industry-certified professional or by a certification or approval body. It is a study draft and may contain errors. Do not use it as instructions for work on a job site or on live equipment. Always follow your instructor, your supervising professional, and current official references and regulations.

VoTechWorks program approval and accreditation are still in progress. Credentials are issued only by the certifying bodies named in each program, after their own exams.

Why File Organization and Version Control Matter

Data science projects generate many files quickly: raw data downloads, cleaned datasets, Jupyter notebooks, visualizations, and written reports. Without a deliberate system, files become impossible to trace, teammates overwrite each other's work, and errors are hard to reverse. Professional data teams solve this with three practices working together: a standardized folder structure, version control through Git, and cloud collaboration through a productivity suite.

Standardized Project Folder Structure

A consistent folder layout means any teammate — or your future self — can navigate a project without asking questions. A widely accepted convention in data science uses these top-level folders inside one project root folder:

Placing a README.md file at the root level is standard practice. A README is a plain-text file written in Markdown that tells readers what the project is, where the data came from, what each folder contains, and how to run any code. It is the first file a new collaborator reads.

File Naming with snake_case

File names should be machine-readable and human-readable. The snake_case convention joins words with underscores and uses only lowercase letters, digits, and underscores — no spaces, no capital letters, no special characters. For example: `sales_data_2024_raw.csv`, `clean_customer_records.csv`, `exploratory_analysis_v1.ipynb`. Spaces in file names break command-line tools and cause errors in many programming environments.

Version Control with Git

Git is a distributed version-control system that records every change you make to a project over time. Each saved snapshot is called a commit. You can review, compare, or restore any earlier commit, which makes it safe to experiment.

Core Git workflow — four commands you use every session:

1. `git init` — creates a new, empty Git repository in the current folder

2. `git add <filename>` or `git add .` — stages files, meaning you are telling Git which changes to include in the next snapshot

3. `git commit -m "descriptive message"` — saves a permanent snapshot with a human-readable message explaining what changed and why

4. `git push origin main` — uploads your local commits to a remote repository on GitHub so others can see your work and it is backed up off your machine

A commit message should be specific: write `Add raw sales CSV and initial README` rather than `update files`. Future reviewers — including yourself — depend on these messages to understand history.

The edit-stage-commit cycle is the normal rhythm of work: make a meaningful change, stage it, commit it with a message, repeat. Committing after each logical unit of work (not after every keystroke, and not after a week of changes) gives you a useful, navigable history.

GitHub

GitHub is a web-based hosting service for Git repositories. A remote repository on GitHub stores your project in the cloud and enables collaboration. After creating a free account and a new repository on GitHub, you link your local project to it with `git remote add origin <URL>`, then push. Your code and its full history become visible and shareable.

Cloud Storage and Collaboration

Google Drive and Microsoft OneDrive are cloud storage platforms bundled with productivity suites (Google Workspace and Microsoft 365 respectively). Both allow you to store files, sync them across devices, and share them with precise permission settings.

Permission levels to know:

For peer review and feedback on a README or report, comment-only access is the appropriate choice: collaborators can annotate without accidentally altering your work. In Google Docs or Word Online, you can add an inline comment by selecting text and clicking the comment icon. The document owner can then resolve a comment once the feedback is addressed, which hides it from the main view while preserving the record.

Safety and Professional Responsibility

Digital workplace safety is real. Several principles apply directly to this work:

Bringing It Together

A professional data project folder committed to GitHub and shared through a cloud platform demonstrates three skills employers look for in every role that touches data: organization, reproducibility, and collaboration. The Google Data Analytics Certificate, IBM Data Science Professional Certificate, CompTIA Data+, and Microsoft PL-300 exam all assume you can navigate and describe a structured project environment — this lab builds exactly that foundation.

Key terms8

snake_caseA file and variable naming style that uses only lowercase letters, digits, and underscores to separate words, with no spaces or special characters — for example, raw_sales_data.csv.
GitA distributed version-control system that tracks changes to files over time, allowing users to save snapshots of a project, compare versions, and collaborate without overwriting each other's work.
commitA saved snapshot in Git that permanently records the staged changes to a project along with a descriptive message about what was changed and why.
staging areaA preparation zone in Git, populated with the git add command, where changes are held before being permanently saved with a commit.
remote repositoryA copy of a Git repository stored on a server or hosting platform such as GitHub, used for backup and team collaboration.
README.mdA plain-text file written in Markdown, placed at the root of a project, that describes the project's purpose, data sources, folder structure, and instructions for use.
comment-only permissionA cloud sharing setting that allows a collaborator to read a file and leave inline comments but not make direct edits to the content.
.gitignoreA plain-text configuration file in a Git repository that lists file names and patterns Git should not track or commit, commonly used to exclude API keys, passwords, and large raw data files.
In class: Set up a standardized project folder structure (raw data, processed data, notebooks, reports, documentation) for a provided sample project; rename files to a specified snake_case convention; create a plain-text README.md file describing the project, data source, and folder contents. · Using Git (command line) and a free GitHub account, initialize a local repository for the sample project folder, stage and commit all files with a descriptive commit message, push the repository to GitHub, and make one deliberate edit followed by a second commit — demonstrating the edit-stage-commit cycle. · Upload the project repository to Google Drive or Microsoft OneDrive, share it with a classmate with comment-only permissions, use the collaboration tools to leave two inline comments on the README, and resolve one comment — demonstrating cloud collaboration workflow.
Materials: Classroom computers with Git installed; GitHub free accounts; Google Drive or Microsoft OneDrive; VS Code or any plain-text editor; Pro Git (Scott Chacon & Ben Straub, free online) chapters 1–2; instructor-provided sample project files and README template
Check: Instructor inspects GitHub repository: correct folder structure present, README.md complete, minimum two commits with descriptive messages — all three criteria must be met for pass; cloud share checked live: correct permission level set and at least one comment resolved.

Practice check8

Answer each question, then check it. Nothing is recorded; this is your own practice.

Data project organization and documentation
1. A teammate opens your project folder for the first time and wants to understand what the project does, where the data came from, and what each subfolder contains. Which file should provide all of that information?
Version control fundamentals
2. Which sequence of Git commands correctly saves a new file called notes.txt to the local repository history with the message 'Add project notes'?
Cloud collaboration and data management
3. You are sharing a project report on Google Drive with a classmate who should be able to annotate it but must not change any content. Which permission level should you assign?
Data organization and workflow best practices
4. A file in a data project is named 'Q1 Sales Report (FINAL v3) NEW.xlsx'. Which snake_case version follows professional naming conventions?
Data security and professional responsibility
5. After pushing your project to a public GitHub repository, you realize the file config.py contains a database password. What is the correct immediate action?
Data project organization
6. Which folder in a standard data science project structure is the correct location for original, unmodified source data files downloaded from an external provider?
Version control best practices
7. A data analyst commits files to Git every few weeks, only when a major milestone is complete. What is the most significant professional risk of this practice?
Version control fundamentals
8. Which Git command uploads your committed local changes to the main branch of a remote repository on GitHub?
Record this lesson on my transcript. Sign in with your key and enrollment email to record lessons (enroll free if you have no key). This page stays open to read and practise.