README: GitHub Settings

GitHub.com

Hackathon Repository Template:

A base template for a common and consistent repository initialise and configuration experience.

Can be
- [ ] Cloned from source template on GitHub.com. ^Quickest
- [ ] Cloned standard fashion.
- [ ] Forked, in public visibility.
- [ ] Downloaded as a zip.

Using a respository template
Clone repository template
Getting Started
Preconfigured Issues Templates
Settings
Acknowledgements

Using a respository template

[ ] Check if the tag | is next to repo name and a green is in top right.
Clone the template repo.

Next Steps

[ ] Create a new repository:
- [ ] Select repository template: {org}/template-hackathon-base.
- [ ] Select a repo owner or {org}.
- [ ] Assign new repo name & description.
- [ ] Do not include all branches from source template (unchecked).
- [ ] Designate: Public or Private.
- [ ] Grant Marketplace apps access.
[ ] New repo should have generated from source template.

Clone repository template

[ ] Clone to local machine.
[ ] Check if all team members can clone and fetch to repository.

Getting Started

Per repository settings: https://github.com/{org/owner}/{repo}/settings

Initial Config

Settings/Features

[ ] Enable, if not already, GitHub Issues.
[ ] If agreed, ✅ enable GitHub Discussions.
[ ] If agreed, ✅ enable GitHub Wiki.
[ ] If agreed, ✅ enable GitHub Sponsorships.

Issue Picker/Config

[ ] Edit 📂./.github/ISSUE_TEMPLATES/config.yml to update urls to new {org/owner}/{hackathon-repo-url}

Preconfigured Issues Templates

Have you:

[ ] Inspect the Issue Templates, preconfigured yaml folder, here.
[ ] Update the Issue Templates urls and markdown references for {org/owner}/{hackathon-repo-name} and for all references.
- [ ] Update: {org/owner}
- [ ] Update: {hackathon-repo-name}
[ ] Have you tested if the issue picker and each issue template button works. Don't commit a new issue, just switch to differengt issue on testing.

Settings

Per repository settings: https://github.com/{org/owner}/{repo}/settings

Features to select:

[x] General
[x] Collaborators

_{Code and automations}

[ ] Branches:
[ ] Tags
[ ] Rules
[ ] ~~Actions~~
[ ] ~~Webhooks~~
[ ] Environments:
[ ] Codespaces
[ ] Pages

_Security

[ ] ~~Code security and analysis~~
[ ] Deploy Keys: Guide
[ ] Secrets and variables
- [ ] Actions
- [ ] Codespaces
- [ ] ~~Depandabot~~

_Integrations

[ ] GitHub Apps
[ ] Email Notifications: Set up notfications for push events.
[ ] ~~Autolink references~~

_{Items strikedout are unlikely needed in a hackathon}

The following are the MRU settings groups/categories. Left blank for team selection and configuration per hackathon.

General

Access: Collaborators

Branches

Rules

Environments

Codespaces

Deploy Keys

Guide

Secrets and Variables

GitHub Apps

Few selections may advance productivity, collavboration and ease of communication etc. Or not.

Email Notifications

Pro:

Setup email addresses for all team members to receive notifications when push events are triggered.

Setup email address for selected/elected team leads (primary/secondary). Team decision & choice.

Con: Risk of spam noise to signal during the hackathon.

Security Config

Security Tab:
- Security policy: enabled: Commit via 📂./.github/SECURITY.md
- Dependabot Alerts

📂.github/

Given the hidden nature of 📂.github/, it is an excellent candiate to store customisation per repoistory instructions, as per below, and other local configs for each team member without impacting the organisation of the visible solutions project files. The benefits of using preconfigured configurations and templares, in a team collborations, are greater consistency and speed to first commit for the solution.

READMEs

📂.github/readme.md (this) is displayed until 📂./README.md is edited and loaded in root of project.
📂.github/ISSUE_TEMPLATES/readme.md outlines the issue templates meta and purposes. Adapt as needed.
📂.github/local-config/readme.md outline the local configurations for post cloning a repository setup. See also ../CONTRIBUTIONS.md.
📂.github/workflow/readme.md outline the GitHub actions in use on the repository.

_{This readme.md is located in 📂./.github intentionally as this is a hidden folder and deals with per repo github settings. Edit as needed.}

Folders

📂.github/ stores the following folders:
- 📂.github/ISSUE_TEMPLATES/ stores issue templates yml GitHub forms. Adapt as needed.
- 📂.github/local-config/ stores the local configurations and samples for a post-cloning repository setup. See also ../CONTRIBUTIONS.md.
- 📂.github/PULL_REQUEST_TEMPLATES/ stores PR template, as onlly one automatic, markdown template. Adapt as needed.
- 📂.github/workflow/readme.md stores the GitHub actions in use on the repository. Some can be located under 📂.github/.

Have you

[ ] Added a root level README.md
[ ] Added a read and familarised self with 📂ISSUE TEMPLATES/readme.md and 📂PULL_REQUEST_TEMPLATES/readme.md.
[ ] Copy the contents of local-config to your prefered local settings/per team member.

Common Files

The following sections cover the common/custom root level files that are best practice and are regularly used. These files can be stored, optionally, under 📂./github/, though by convention are stored under the root: 📂./

^{Edit Templates in name or with .tmpl extension and remove .tmpl|.md.tmpl when ready}