If you want to contribute to Proethos2 and make it better, your help is very welcome. Contributing is also a great way to learn more about social coding on Github, new technologies and their ecosystems and how to make constructive, helpful bug reports, feature requests and the noblest of all contributions: a good, clean pull request.
Look for a project's contribution instructions. If there are any, follow them.
- Create a personal fork of Proethos2 on Github.
- Clone the fork on your local machine. Your remote repo on Github is called
origin
. - Add the original repository as a remote called
upstream
. - If you created your fork a while ago be sure to pull upstream changes into your local repository.
- Create a new branch to work on! Branch from
develop
if it exists, else frommaster
. - Implement/fix your feature, comment your code.
- Follow the code style of Proethos2, including indentation.
- Run the tests!
- Write or adapt tests as needed.
- Add or change the documentation as needed.
- Push your branch to your fork on Github, the remote
origin
. - From your fork open a pull request in the correct branch. Target Proethos2's
develop
branch if there is one, else go formaster
! - If the maintainer requests further changes just push them to your branch. The PR will be updated automatically.
- Once the pull request is approved and merged you can pull the changes from
upstream
to your local repo and delete your extra branch(es).
And last but not least: Always write your commit messages in the present tense. Your commit message should describe what the commit, when applied, does to the code – not what you did to the code.
This links will help you if you want to be a developer from Proethos2 project, or help as you can, not necessarily as developer. If you have any questions, please open an ticket here.
- Instructions to use Make shortcuts
- Relations between Proethos2 and XML ICTRP
- Translation Guide
- How to migrate from Proethos1
- How to generate help messages in database to my new development
- How to generate new database initial data from my dev environment
- How to configure reCaptcha for registration form
- How to add routines in crontab
- How to create custom fields
- How to change the Submission Flow
- How to delegate user roles on the first access using Oauth2 authentication (Azure AD)
- How to apply the encryption patch to the database (required if ProEthos2 >= 1.6.0)
- ProEthos data model
- ProEthos architecture diagram