To prevent "repo sprawl" (creating repos for individual courses), GDI has track- or subject-matter-specific repositories that contain individual courses:
❗ Use this template repo to create a new technical track or subject-matter repository; do not use this template to start a new course.
- To start a new course, go to a specific track repo (see the list above) and use the
_course-template
folder in that repo.
This template repo contains a _course-template
folder and a shared-assets
folder.
The _course-template
folder is the template for creating individual courses that go into the primary track or subject-matter repo.
- The
_course-template
folder includes a README with instructions for creating courses.
The shared-assets
folder holds custom GDI css
, images
, js
files that all course folders in a primary track repo reference.
- ❗ Do not add course-specific assets or content to the shared-assets folder.
To create a new track or subject-matter repo:
-
Start and name a new repo in GDI's main or organizational github account
-
Duplicate the contents of this template repo and add them to the new repo
-
Delete the contents of this README, and update with a description about the new repo
-
Duplicate the
_course-template
folder to create or start new courses- ❗ Do not delete the
_course-template
folder; it should always be available to create other courses - A track repo can contain more than one course
- ❗ Do not delete the
-
Make sure to include/keep the
shared-assets
folder in the new repo -
Create a
.gitignore
file in the new repo's root directory to exclude hidden system files -
RECOMMENDED: Create an empty
.nojekyll
file in the new repo's root directory; this allows the repo to bypass Jekyll processing for Github Pages