Why an SVN, what are the advantages?
There are numerous advantages for an SVN, but some of the important ones are listed below.
- There is a changelog
- Access to the latest changes all the time
- No need to download one big pk3, just update the new/changed files
- Backup purpose
- People can work at the same time on different parts of the project
- Work doesn't get lost if updates were made frequent enough
It's easy to use, it's fast, and it's very easy for such a large project to be organized.What software do I have to install before I can use the HPack SVN?
It's not that much, actually only two programs are required to use the SVN, so simply download both of them and install them just as they are.
These tools are not necessary if you are using your own programs to manage and work with SVN's, but the ones that I have posted are for free and have simply proven themselves being worthy while working on TSoZD and Stronghold.What is the login data?
To make sure that changes can be backtracked, everyone in the HPack team gets a personal login with a personal password. Simply send me a pm and ask for an account before moving on, you will need it.After installing both programs, what do I have to do next?
The hardest part is already done by now, what's left to do are just getting the latest subversion and then you can actually start working, start updating and start being as productive as possible. Just follow these easy steps to set up your development folder.
- Create a new working directory where you want to place all the HPack files
- Right click on the new folder, then click on "SVN Checkout"
- For the URL, use "svn://drdteam.org/hpack", leave everything else as it is and move on.
- On the next window you need the username and the password, you have been given before by me, put that in, save the authentification and then proceed.
- Next step is updating your local folder with the latest data on the svn, for this, simply click on the new folder again, and this time on "Update SVN"
- Now TortoiseSVN will start downloading the latest subversion to your local folder, depending on your connection, this will take some time, just be patient.
As soon as you're done with the download, you are ready to start your work. Update and fix bugs, work on your maps, upload new content.That's all easy and nice, but how do I update/upload content?
Also very easy. ToirtoiseSVN keeps track of all the changes you are doing in the HPack SVN directory and marks altered files with a red exclamation mark.
- Everytime you are done editing a map or a file, just make sure to upload it by right-clicking on your root directory OR the file itself and then click on "SVN Commit..." to submit your changes to the SVN.
- In the next window the only thing you have to do is writing a precise description of your changes so other people know what's new about the updated files. After writing this description, simply click on "Okay" and your changes were submitted.
Adding new content is also quite easy but a bit different.
Is that all?
- When adding completely new files (like sprites, music, maps or stuff) to the local svn directory on your machine, these files get a blue interrogation mark.
- If you want to add these files now, simply mark them and click on "TortoiseSVN > Add..." and proceed natively with the dialogue windows
- After that, make sure to do another "SVN Submit" with a little description (but that goes without saying) so the files also move to the svn repository so others can download these again.
Well, if you know how to connect, if you know how to update your local directory to the latest versions online, if you know how to commit changes and how to add new files, you are ready to go. Just a small important rules and hints that you need to read carefully:
- Update your local files everytime you edit something
- Upload progress (especially maps) as often as possible
- Do not delete/rename files, but feel free to suggest deletions/renamings
Other than that, I hope that this SVN will speed up the development and also bring some more motivation and activity into this project, HPack deserves it
By the way, if you notice problems, let me know!