Creating a Repository
This guide explains how to create a new repository. Remember – if you create a repository you are responsible for maintaining it.
A good repository name allows users to accurately guess its contents. Repositories in
Flutter-Global follow the conventions:
- repository names MUST be lower case, using a dash (
-) as a word separator.
- use a relevant prefix to group several related repos together. e.g. for the fixed odds cashout quote functionality this is
- for the primary repository of an application use
- each division usually maintains its own deployment repository for specific divisional configuration. If these repos live in Flutter-Global they usually contain
configto indicate their contents. Show divisional ownership with a suffix (e.g.
fcq-config-ppbcontains PPB deployment config for the FCQ service.
Every user in Flutter-Global has permission to create a new repository in the normal way in GitHub. Use the + drop-down menu on the top-right corner of a GitHub page and select New repository.
In the Owner drop-down, select Flutter-Global.
Enter the name of your repository and a description.
In Flutter-Global, all repositories are
Private. If you want something different, contact the inner source team. Choose how you want to initialise then continue to create the repository. Creating a repository gives you an empty sandbox repository that you have full control over, and only you have access to. To share the repo, you need to configure it.
Configure Your Repo
To setup your repository:
- Choose a branching model: how do contributors propose changes, and who approves them?
- Choose an access model: who can access the repository, and with what permissions?
- Use Codebase Governor to quickly and easily setup (1) and (2) in an audit friendly way.