New-repo

Updated 186 Days AgoPublic

Actions

New repositories should be created in Phabricator and mirrored to GitHub.

Procedure depends if you can or not create a repository in Nasqueron orgz on GitHub. To do so, you must be a member of the Nasqueron orgz on GitHub, something you can ask to @dereckson

From 2020-09-25, any new repository should use main instead of master as the reference branch.

You would like to clone a repository already initialized

From experience, we know to create a repository correctly is not an easy task,
especially with traps like how to do the first commit with Arcanist or not
populate the GitHub mirror.

As such, the easiest is to just ask us to create the repository,
and watch the different steps we used for your next one.

Request a repository

You want to do it yourself

You have don't have access to GitHub

1. Create the repository here
2. Create a task against DevCentral project to require to mirror it to GitHub, with a link to this document

You have access to GitHub

DevCentral

1. Generate a deployment SSH key to allow GitHub interaction
   1. Name: Deployment key for GitHub nasqueron/foo
   2. Lock permanently: check
2. Create the repository
   1. Name: the descriptive, typography-rich repository name, e.g. Phantom and Ghosts
   2. Callsign: a short uppercase symbol, like an abbreviation, e.g. PG
   3. Short name: the name of the repository folder when you clone it, e.g. phantom-ghosts
3. Add a new remote URI
   1. URI: git@github.com:nasqueron/foo.git
   2. I/O type: Mirror
   3. Display type: Default (= hidden)
4. Change default branch to main (manage > branches)
5. Activate the repository (manage > basics)
6. Tag it with a project (Notifications center will use it to know where announce related events)

GitHub

1. Create a new repository with hub create nasqueron/foo or visiting https://github.com/new
   1. Privacy : Check Public option
   2. Add a README file : Don't check the box, as the repository should be created empty. First commits should be reviewed on DevCentral too.
2. Go to https://github.com/nasqueron/foo
3. Add the deploy key to https://github.com/nasqueron/foo/settings/keys
   1. Use something like DevCentral (K00) where K00 is the Passphrase object as title
   2. Allow write access
4. Consider to add the repo to a relevant team: https://github.com/orgs/nasqueron/teams

What to do afterwards?

You may create and commit the following files:

Special tags

Those projects-as-a-tag allow to tag repositories for a specific purpose: