👍 First off, thanks for taking the time to contribute! 👍
We are really glad to have you on board !
- Please do not assign issue to anyone.
- You may assign an issue to yourself, meaning to others "I'm actually working on this issue".
- When closing an issue, please add a comment explaining why you are closing it.
- Docker
sudo apt install maven git
Either choose an existing issue on which you'd like to work or create a new one. Identify its id. For example, the id of https://gitlab.com/asqatasun/Asqatasun/-/issues/115 is 115
, we'll use it later.
From GitLab, fork the project. You've got your own personal Asqatasun under your GitLab user environment (https://gitlab.com/<user>/Asqatasun
).
git clone https://gitlab.com/<user>/Asqatasun.git
# instead of: git clone https://gitlab.com/asqatasun/Asqatasun.git
cd Asqatasun
git checkout -b <id-of-issue>-fix
# git checkout -b 115-fix
Note: create a branch based on the master
branch.
Add your code, do your commits.
./docker/build_and_run-with-docker.sh --source-dir $(pwd) --docker-dir docker/SNAPSHOT-local
Check in your browser at http://localhost:8085/asqatasun/. You may compare with https://app.asqatasun.org/
git push origin <id-of-issue>-fix
# git push origin 115-fix
Create it:
- from your personal repos / your branch
- to the Asqatasun repos /
master
branch
Validate, a maintainer will review and hopefully merge your pull request.
Thank you for contributing to Asqatasun !
Those resources are meant to help:
- Asqatasun Contributor doc,
- and especially Asqatasun, Git, GitLab: getting started
- and anyway the Forum
- For contributors doc Gitlab Workflow
- Atom's Contributing file that is really good and brightly written.