Skip to content

🟠 Workflow C: Start New Custom Project

Start your own project based on the example.

Your new project will have its own GitHub repository, Git history, code, and documentation.

WHY?

Professional work often involves learning from existing projects and applying proven techniques to new problems.

This workflow develops the ability to understand an example, and use that example to create a new project that you can experiment with and use to solve new problems.

⚠️ New to Terminals, Git, or Repositories?

This guide assumes you can open a terminal and run a command. If that is new to you (it often is), start with Applied Computing Foundations, a short prerequisite.

⚠️ Get Your Machine Ready First

Complete 🟢 Workflow A: Set Up Machine first. This phase requires successful completion of all those steps.

Plan Your Project and Create Your Repository

  1. Plan Your Custom Project
  2. Create Your New GitHub Repository
  3. Configure Repository Settings
  4. Clone Your New Repository
  5. Open Your Cloned Repository in VS Code
  6. Customize README.md
  7. ⭐Git Add-Commit-Push to GitHub

Review and Take Ownership of the Project Code

After making your first git add-commit-push, review the important project code files, understand their purpose, and customize the heading of each source file to indicate that this project will hold your custom work.

  1. Review project configuration
  2. Set up Environment (managed by uv)
  3. Install and Run Git Hooks
  4. Take Ownership of Code Files
  5. ⭐Git Add-Commit-Push to GitHub

Success

This workflow is complete when you can:

  1. Provide a clickable link to your custom GitHub repository.
  2. Open your custom project in VS Code.
  3. Explain the purpose of the main project files and folders.
  4. Identify and explain your project-specific configuration changes.
  5. Set up the Python environment and run the project checks.
  6. Commit and push your changes to your custom GitHub repository.

◄ Back to 🏠 Guide Home