Skip to content

Add forking docs#104

Merged
Erikhu1 merged 6 commits intomainfrom
add_forking_docs
Oct 24, 2025
Merged

Add forking docs#104
Erikhu1 merged 6 commits intomainfrom
add_forking_docs

Conversation

@Erikhu1
Copy link
Collaborator

@Erikhu1 Erikhu1 commented Oct 15, 2025

Add documentation on all settings that need configuring when creating a fork of the repo.

@github-actions github-actions bot added documentation Improvements or additions to documentation M labels Oct 15, 2025
@coveralls
Copy link

coveralls commented Oct 15, 2025

Coverage Status

coverage: 99.186%. remained the same
when pulling 8c210cc on add_forking_docs
into 8c92b80 on main.

@github-actions github-actions bot removed the M label Oct 16, 2025
@Erikhu1 Erikhu1 marked this pull request as draft October 17, 2025 14:03
@github-actions github-actions bot added M and removed M labels Oct 21, 2025
@Erikhu1 Erikhu1 marked this pull request as ready for review October 22, 2025 12:43
Copy link

@Jonas-Kirchhoff Jonas-Kirchhoff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have a few minor comments.

TSF/README.md Outdated

In order to fork this repository or set up any repository where the TSF documentation in this repository is to be included, the following settings have to be configured on GitHub.

- In `Settings` > `Features`:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Settings > General > Features

TSF/README.md Outdated
Comment on lines +20 to +26
- Enable `Require a pull request before merging`
- Enable `Require approvals`
- Enable `Require review from Code Owners`
- Enable `Require status checks to pass before merging`
- Enable `Require branches to be up to date before merging`
- Enable `Require linear history`
- Enable `Do not allow bypassing the above settings`

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe also possible (just suggestion): Make sure that only the following settings are enabled: - ...

TSF/README.md Outdated
- Enable `Require branches to be up to date before merging`
- Enable `Require linear history`
- Enable `Do not allow bypassing the above settings`
- Click `Create`

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is possible to write something into the Branch name pattern and then hit enter, which creates the branch protection rule.

TSF/README.md Outdated
- Enable `Do not allow bypassing the above settings`
- Click `Create`

- In `Settings` > `Actions` > `General` > `Workflow Permissions`:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Settings > Code and Automation > General > Workflow Permissions

TSF/README.md Outdated
Comment on lines +30 to +32
- Enable `Read repository contents and packages permissions`
- Disable `Allow GitHub Actions to create and approve pull requests`
- Click `Save`

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To leave no room for confusion: Make sure that only the following settings are enabled: Allow all actions and reusable workflows, Require approval for first-time contributors, Read repository contents and packages permissions .

Do we want to give a recommendation for the artifact retention period?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the artifact retention period, is there any reason one should not use the maximum of 90 days?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From my understanding, no.

TSF/README.md Outdated
- Disable `Allow GitHub Actions to create and approve pull requests`
- Click `Save`

- In `Settings` > `Pages`:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Settings > Code and Automation > Pages

TSF/README.md Outdated
Comment on lines +38 to +39
- Enable `Dependency graph`
- Enable `Dependabot alerts`

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make sure that the following settings are enabled, only: Dependency graph, Dependabot alerts, Secret Protection, Push protection. What about CodeQL?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The pipeline automatically enables CodeQL after merging to main. If one tries to enable it manually the pipeline it will prompt you to use GH default CodeQL configuration or set up a custom one. Neither one is what we want.

TSF/README.md Outdated
- In `Settings` > `Features`:
- Enable `Issues`

- In `Settings` > `Branches` > `Add classic branch protection rule`:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Settings > Code and Automation > Branches

@github-actions github-actions bot added M and removed M labels Oct 22, 2025
@github-actions github-actions bot added M and removed M labels Oct 23, 2025
@Erikhu1 Erikhu1 merged commit 36474e8 into main Oct 24, 2025
83 checks passed
@Erikhu1 Erikhu1 deleted the add_forking_docs branch November 4, 2025 15:14
Erikhu1 added a commit that referenced this pull request Nov 14, 2025
* add documentation on how to fork

* change branch name pattern

* fix fnmatch pattern

* change master to main

* correct forking docs

* implement feedback
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants