Update README.md - add travis badge and rework of the Contributing section
This commit is contained in:
parent
4513feaf26
commit
8c5de6162e
1 changed files with 18 additions and 10 deletions
28
README.md
28
README.md
|
|
@ -1,3 +1,5 @@
|
||||||
|
[](https://travis-ci.org/zertrin/duplicity-backup)
|
||||||
|
|
||||||
# duplicity-backup.sh
|
# duplicity-backup.sh
|
||||||
|
|
||||||
This bash script was designed to automate and simplify the remote backup process of [duplicity](http://duplicity.nongnu.org/) on Amazon S3 primarily. Other backup destinations are possible (Google Cloud Storage, FTP, SFTP, SCP, rsync, file...), i.e. any of duplicity's supported outputs.
|
This bash script was designed to automate and simplify the remote backup process of [duplicity](http://duplicity.nongnu.org/) on Amazon S3 primarily. Other backup destinations are possible (Google Cloud Storage, FTP, SFTP, SCP, rsync, file...), i.e. any of duplicity's supported outputs.
|
||||||
|
|
@ -29,27 +31,31 @@ This means the following:
|
||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
Latest version of the code is available at https://github.com/zertrin/duplicity-backup in the `master` branch.
|
The development version of the code is available at https://github.com/zertrin/duplicity-backup in the `dev` branch. It is a bleeding-edge version with the latests changes that have not yet been tested a lot, but that's the best starting point to contribute.
|
||||||
|
|
||||||
Pull requests are welcome! However please **always use individual feature branches for each pull request**. I may not accept a pull request from a master branch.
|
Pull requests are welcome! However please **always use individual feature branches for each pull request**. I may not accept a pull request from a master or dev branch.
|
||||||
|
|
||||||
Here is how to do it:
|
Here is how to do it:
|
||||||
|
|
||||||
Fork the repository and then clone your fork:
|
Fork the repository first and then clone your fork on your machine:
|
||||||
|
|
||||||
git clone git@github.com:YOURNAME/duplicity-backup.git
|
git clone git@github.com:YOURNAME/duplicity-backup.git && cd duplicity-backup
|
||||||
|
|
||||||
Create a new topic branch for the changes you want to make, based on the master branch from the clone:
|
Add a remote for the upstream repository:
|
||||||
|
|
||||||
git checkout -b my-fix-1 origin/master
|
git remote add upstream git@github.com:zertrin/duplicity-backup.git
|
||||||
|
|
||||||
|
Create a new topic branch for the changes you want to make, based on the `dev` branch from upstream:
|
||||||
|
|
||||||
|
git checkout -b my-fix-1 upstream/dev
|
||||||
|
|
||||||
Make your changes, test them, commit them and push them to Github:
|
Make your changes, test them, commit them and push them to Github:
|
||||||
|
|
||||||
git push origin my-fix-1
|
git push origin my-fix-1
|
||||||
|
|
||||||
Open a Pull request from `YOURNAME:my-fix-1` to `zertrin:master`.
|
Open a Pull request from `YOURNAME:my-fix-1` to `zertrin:dev`.
|
||||||
|
|
||||||
If you want to open another pull request for another change which is independant of the previous one, just create another topic branch based on master (`git checkout -b my-fix-2 origin/master`)
|
If you want to open another pull request for another change which is independant of the previous one, just create another topic branch based on master (`git checkout -b my-fix-2 upstream/dev`)
|
||||||
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
@ -60,14 +66,16 @@ You can clone the repository (which makes it easy to get future updates):
|
||||||
|
|
||||||
git clone https://github.com/zertrin/duplicity-backup.git duplicity-backup
|
git clone https://github.com/zertrin/duplicity-backup.git duplicity-backup
|
||||||
|
|
||||||
If you prefer the stable version:
|
If you prefer the stable version do:
|
||||||
|
|
||||||
git checkout stable
|
git checkout stable
|
||||||
|
|
||||||
... or if you want the latest version:
|
... or if you want the latest version (might still have bugs), then:
|
||||||
|
|
||||||
git checkout master
|
git checkout master
|
||||||
|
|
||||||
|
... or if you like living on the edge, you can stay at the development version which is automatically cloned.
|
||||||
|
|
||||||
Or just download the ZIP file:
|
Or just download the ZIP file:
|
||||||
|
|
||||||
* For the stable branch: https://github.com/zertrin/duplicity-backup/archive/stable.zip
|
* For the stable branch: https://github.com/zertrin/duplicity-backup/archive/stable.zip
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue