Next steps

Tasks to do in your project after applying the template to it.

While most of the post-copy steps are listed in the created TODO.md file within the project, this documents some more details for these steps. Use this guide alongside the TODO.md to complete those tasks. There are post-copy tasks for two types of people: the person creating the project and the person who will actually use it. Sometimes these are the same person, but in DP-Next they are usually two different people. That’s because we need to do some GitHub admin tasks after creating the repository that only some people have access permissions for. So this guide is split into those two people: creator and researcher.

Creator

Setting up a GitHub repository

Warning

These series of steps are only necessary if you are using this template for a repository that is part of the Seedcase Project. If you want a quick way of putting your project on GitHub, you can use the gh command line tool to upload the project to GitHub:

Terminal

gh repo create ORG/REPO --source=. --public

We have a custom command line tool that we developed to help manage GitHub repositories for Seedcase Project repositories. While it’s useful for us, it isn’t designed or build in a way that makes it easy for others to use.

For setting up a GitHub repository for the created project that will be part of the Seedcase Project, you’ll need to install our internal tool spaid and use the following commands to run the next setup steps:

Terminal

spaid_gh_create_repo_from_local -h
spaid_gh_set_repo_settings -h
spaid_gh_ruleset_basic_protect_main -h
spaid_gh_ruleset_require_pr -h

Some configuration is needed after copying this template to a new repository, including configuration external to the repository. Some GitHub workflows require installing GitHub Apps, for greater security purposes and easier administration when managing multiple repositories. The security section in our Guidebook provides some instructions on how to set up GitHub Apps, secrets, and variables. Ideally the secrets and variables should be set up in the organization settings. The specific workflows in this template that require this additional setup are:

The workflow .github/workflows/add-to-project.yml requires the add-to-board-token GitHub App (another Seedcase app), along with the ADD_TO_BOARD_TOKEN secret and the ADD_TO_BOARD_APP_ID variable of the GitHub App’s ID.

Researcher

For now, the TODO.md file contains enough information on what the next steps are for the researcher.