This is an old revision of the document!
What is a repository?
Simply speaking, think of a repository as a folder inside which files and sub-folders are stored. But it is actually more than that: It also stores earlier versions of the files in there too. When you use Git Winch usually you would create more than one repository – each one created to ensure that the members working on the files therein only handle just those files they need to work on, and not others. So the work of an office can be separated on a need-to-know basis. In case someone leaves the office, that person does not get the entire data of the office (which would have been the case if he/she was working without Git Winch!)
How to create a new repository
A new repository can be created either by the owner or by another trusted person.
The Personal Access Token must be correctly created with the create repository permission. If you are the owner of that PAT, you should enter that key in the PAT text-input box on the Manage page, and then proceed to create a repository.
A repository can be created by someone else too, say a trusted manager of some repository. In that case, the owner of the PAT should create an encrypted version of the PAT and share that encrypted version to that trusted person. That person should NOT enter that encrypted key into the PAT text-input box. (i.e. that box must be left empty) Instead, Git Winch will specifically ask for the encrypted PAT and then proceed to create a new repository.
Read more about PAT here.
Restrictions
The new repository name must be lower-case alphanumerical (and you can give underscore too) You MUST create repositories ONLY from within Git Winch. That means you cannot go to the said Git Host and create a repository there or use some other tool to create repositories.
IMPORTANT
You cannot clone a repository immediately after you have created it –even if you are the owner! You will have to first created deploy keys for yourself and other office workers you want to work in that repository. And; you will also have to add yourself (and those workers) as a member of that repository.
Hover your mouse over those buttons, and press F1 for their help.