Working with SubVersion

You may have work that you want to keep under version control, but for which github is not a suitable platform. For such situations you can work with SubVersion.

To work with SubVersion you need to execute the following steps:

1. Download and install Tortoise SVN (https://tortoisesvn.net/) you may need a restart after installation
2. In a file explorer create a directory c:\checkouts\[your_repository_name] and open it
3. Right click the empty space in the file explorer and select "SVN Checkout" in the context menu
4. In the field "URL of repository" enter "https://svn.citg.tudelft.nl/[your_repository_name]" and click OK
5. The program should ask for your netid and password. Select the option to save the authentication information to avoid having to re-authenticate every time.

The content of the repository is now downloaded from the server to your computer.

You may have noticed that right clicking in a file explorer you now have a number of svn related options. Here are the most used:

• add: mark a new document using 'add', the svn client will now understand it needs to include this file in the next commit (https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-add.html)
• commit: any changed or added file will be uploaded from your computer to the server (https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-commit.html) – good practice: always provide a comment with your commit
• update: any changes on the server committed by others will be downloaded from the server to your computer (https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html)

So for others to see a file you made, or a change to a document you made, you need to commit the information to the shared server and they need to update to get the latest changes (and vice versa of course). Regular committing and updating is the way to keep things working properly. To avoid conflicts a good practice tip is to update first, then make changes to a file, and immediate commit back to the server. A full guide on how to use subversion is found on: https://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html