YouSource provides great infrastructure for projects which use Git as version control system. With YouSource it is easy to collaborate on your projects.

To store your files in YouSource you first need to create a new project. Under your project you can create a new repository or several repositories which then can be used to store your files.

You can login to YouSource with your Korppi credentials so there’s no need to register. Login is required to create projects and repositories.

Add files to your repository

There are three ways to add files into a repository on YouSource.

  • Update with zip (see the sidepanel on your repository’s page)
  • Upload single files (from your repository’s source tree browser)
  • Use Git (the preferred way)

Use Git with YouSource

See Git_Help to learn to use Git with YouSource.

For general help with Git you should take a look at the Pro Git book. Reading just the first three chapters should get you going with Git and it’ll only take about half an hour. If you are used to using other version control system than Git you might also want to read chapter 8, Git and Other Systems.

Before you can push to your repository in YouSource you need to add an SSH key. Also, if the repository is not public you need an SSH key for cloning as well.

Add and manage SSH keys

You need to add an SSH key for every computer from which you use YouSource with Git. You can manage your SSH keys by clicking on the “Manage SSH keys” button on your dashboard.

user settings

To learn how to make an SSH key, see the SSH_key_help.

Create a team

You can create a new team from the Teams page.

Add collaborators to projects and repositories

To add collaborators to projects you first have to create a new team. After that, go to your project’s page and click ‘Edit project’ from the side panel. There you can transfer the ownership of the project to the team.

To add collaborators to repositories you can go to your repository’s page and click
‘Manage collaborators’ from the side panel. If the repository is under a project that is
owned by a team, the team members are already collaborators of the repository.

Make releases of your code

There are two ways to make releases, either through the WWW interface or via Git. Note that whether or not your repository is private the release will be visible to everyone.

Making releases via WWW interface is simple: go to your repository’s page and choose ‘Make release’ from the sidebar. Fill in the form and submit.

Making releases via Git is possible by pushing release metafiles. The release metafiles have to be saved in ‘releases’ folder in the metafiles branch with the version as filename. For example, if you save the file as ‘releases/1.0’
the release will have the version ‘1.0’. You can also remove releases by deleting the corresponding release metafiles from your repository, so be careful.

The release metafiles should be in YAML format. There should be an example file in the metafiles branch of your repository in YouSource.

Change the visibility of your projects and repositories

You can change the visibility of your projects and repositories from their settings (click the edit link in the sidebar of your project or repository).

Projects have three visibility levels:

  1. visible to everyone,
  2. visible to logged in users and
  3. visible to collaborators.

Repositories have only two visibility levels: public and private. However, the visibility of repositories is also affected by the visibility of the corresponding project. That means, if your project is private, all repositories under that project are private. If you make the project public all the repositories will become public too unless they have been marked as private from their own settings.

To make your private projects and repositories visible to certain people you have to add them as collaborators.