|
|
| (10 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| * [[Guidelines:Index|All Guidelines]]
| |
|
| |
|
| == Developer Workflow ==
| |
|
| |
| === Prerequisites ===
| |
|
| |
| Additionally, you will need:
| |
|
| |
| * [https://git-scm.com '''git''']
| |
| * a suitable programming editor (e.g. [https://kate-editor.org Kate])
| |
|
| |
| === Forking Sahana Eden ===
| |
|
| |
| Start by creating your own fork of '''Sahana Eden''':
| |
| * Login to [https://github.com|'''GitHub'''] (create yourself an account, if you don't have one yet)
| |
| * Navigate to https://github.com/sahana/eden
| |
| * Click on the '''Fork''' button, and follow the instructions to create a new fork
| |
|
| |
| This will create a new GitHub repository ''[yourname]/eden''<sup>*</sup>, which is your own copy of ''sahana/eden'' - and the repository you will work on.
| |
|
| |
| <sup>*</sup> ''[yourname] here stands for your GitHub username''
| |
|
| |
| === Creating a Local Clone ===
| |
|
| |
| Follow the steps in the [https://eden-asp.readthedocs.io/en/latest/dev/setup.html '''Developer Handbook'''] to set up a local instance of Sahana Eden.
| |
|
| |
| When you get to [https://eden-asp.readthedocs.io/en/latest/dev/setup.html#installing-eden '''Installing Eden'''], make sure to clone your own fork:
| |
|
| |
| <code>
| |
| git clone --recursive https://github.com/[yourname]/eden.git ~/eden
| |
| </code>
| |
|
| |
| ...instead of ''sahana/eden''.
| |
|
| |
| Finally, configure ''sahana/eden'' as upstream repository for your clone:
| |
|
| |
| <code>
| |
| git remote add upstream https://github.com/sahana/eden.git
| |
| </code>
| |
|
| |
| Now you can use this local instance to test-run and verify your changes.
| |
|
| |
| === Adding the Development Branch ===
| |
|
| |
| All development should be based on the <code>dev</code> branch of ''sahana/eden''. To get a copy of that branch into your local clone, change into the ''eden'' folder and run these two commands:
| |
|
| |
| <code>
| |
| git checkout -b dev
| |
| </code>
| |
|
| |
| <code>
| |
| git pull upstream dev
| |
| </code>
| |
|
| |
| This adds a copy of the Sahana Eden dev branch to your local clone, and checks out the latest developer version of the code.
| |
|
| |
| === Creating Story Branches ===
| |
