Skip to content

MattToegel/project-guide-template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Project Name

Author: [Your Name Here]

Link to the original repository

Project Overview

This project is designed to [briefly describe the project's goals and features]. The project involves tracking and completing checkpoints, with GitHub Actions automating issue generation and tracking progress.

Each checkpoint tag pushes a new set of tasks (issues) and updates the project's progress in this README.md file automatically.

Getting Started

To get started with the project, follow these steps to set up the repository, fork it, and configure it for automatic issue generation and progress tracking.

1. Fork the Repository

First, fork the original repository by clicking the "Fork" button on the top right corner of the GitHub page or using this link:

Link to fork the repository

2. Clone Your Forked Repository Locally

# Clone your forked repository to your local machine
git clone https://github.com/your-username/your-forked-repo.git
cd your-forked-repo

3. Set Up Workflow Permissions for GitHub Actions

To allow the GitHub Actions workflow to manage issues and update the README.md file automatically, follow these steps:

  1. Go to Settings > Actions > General in your forked repository.
  2. Scroll to the Workflow permissions section.
  3. Select Read and write permissions.
  4. Check the box for Allow GitHub Actions to create and approve pull requests.
  5. Click Save.

4. Update Author Name

In the root of the repository, update this README.md file to reflect your name as the project author.

Replace:

**Author**: [Your Name Here]

With your name:

**Author**: Your Name

5. Persist Changes and Push

After updating the author name, persist your changes locally and push them back to GitHub:

# Stage your changes
git add README.md

# Commit your changes
git commit -m "Update README with author name"

# Push your changes to GitHub
git push origin main

6. Create the First Tag to Get Started

To start the project and initialize the workflow, create the first tag checkpoint-0:

# Create the initial tag for checkpoint-0
git tag checkpoint-0

# Push the tag to GitHub
git push origin checkpoint-0

Once this tag is pushed, the GitHub Action will automatically generate the first set of issues and update the README.md with the completion progress.

As you progress, each time you finish a set of issues of a given checkpoint, repeat the above steps with the current checkpoint number to progress through the project.

Note: This process takes about 30 seconds or so to complete.


Checkpoint Progress

The following section will be dynamically updated as checkpoints are completed. Do not delete or modify the special comments as they are used to insert progress updates automatically when tags are pushed.


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published