====== 05 Collaboration ======

> //Information on how to collaborate on our offerings in alignment with our way of working: How to consume them, how to modify them, and how to integrate your changes back into our codebase. [[kb:bestpractices:wow:methodology|Looking for information on how we collaborate in daily work based on our working principles?]]//

==== Get git up and running ====

  * [[processes:version-control|install and setup git]]

==== Get familiar with our way of working ====

  * [[kb:bestpractices:wow|Way Of Working]]
  * [[kb:bestpractices:codingconventions|Coding Conventions]]
  * [[kb:bestpractices:scc:rules|Source Code Control - Rules & Guides]]
  * [[kb:bestpractices:scc:gitflow-workflow|Source Code Control - Workflow Model]]
  * [[kb:bestpractices:documentation|Documentation]]

==== Get familiar with our existing code ====

  * pull the [[https://code.hampel-soft.com/open-source/dqmh/hse-application-template|hse-application-template]] repo from [[https://code.hampel-soft.com|our GitLab server]]
	
  * read the documentation
    * [[code:common|Code: Common]]
    * [[code:dqmh:hse-application-template|Code: Application Template]]

==== Get to work ====

  * Browse the issues list - for example [[https://code.hampel-soft.com/open-source/dqmh/hse-application-template/-/boards|here]] - if you don't have a specific feature in mind. If you already know what you want to add, create an issue for your new feature first!


== For Open-Source Projects ==

  * Read up on the [[kb:bestpractices:scc:project-forking-workflow|project forking workflow]]
  * Fork the repo
  * Implement your changes using Gitflow
  * Finish and push your features
  * Create a Merge Request

== For Customer Projects ==

  * Create an account on [[http://code.hampel-soft.com|our GitLab server]]. This allows us to grant write access to repositories, so you can use the [[kb:bestpractices:scc:gitflow-workflow|gitflow workflow]]
  * Clone the repo
  * Implement your changes using Gitflow
  * Finish and push your features