Difference between revisions of "PKC on Github"

From PKC
Jump to navigation Jump to search
Line 1: Line 1:
This page intention is to become the standard workflow to develop the PKC's solution on Github. Please find the Github Repository at [https://github.com/Personal-Knowledge-Container PKC GitHub Repository]. All contributor will work on this repository and will use [https://pkc.pub PKC Mediawiki] as documentation platform.
This page intention is to become the standard workflow to develop the PKC's solution on Github. Please find the Github Repository at [https://github.com/Personal-Knowledge-Container PKC GitHub Repository]. All contributor will work on this repository and will use [https://pkc.pub PKC Mediawiki] as documentation platform.
=Development Procedure=
=Development Procedure=
[[File:Git-ci-cd-workflow.png|60-px|thumb|right|alt=Picture 1:CI/CD Workflow on Github|Picture 1:CI/CD Workflow on Github]]
The development procedure will follow below process, displayed on PDF. Please clone and create new branch from master for each feature that will be develop, and the review will going through below stages:
The development procedure will follow below process, displayed on PDF. Please clone and create new branch from master for each feature that will be develop, and the review will going through below stages:
# [dev], Development stage
# [dev], Development stage
# [qa], Quality Assurance stage
# [qa], Quality Assurance stage
# [production], Production stage, this is the branch that will published and contained the latest stable version of the code.
# [production], Production stage, this is the branch that will published and contained the latest stable version of the code.
<pdf width="800" height="800">File:CICD in GitHUB.pdf</pdf>
Please refer to Picture 1 for schema.
 
To start work on your feature, please follow below code from you localhost.
<syntaxhighlight lang=shell>
# for example, you are working on pkc-agent repository
$ git clone https://github.com/Personal-Knowledge-Container/pkc-agent.git
 
# create new branch, add 'dev' prefix
$ git checkout -b dev-[your-feature-name]
Switched to a new branch ‘dev-[your-feature-name]’    # git will tell that you are working on your branch
# Then, you can start working on your feature on this branch
</syntaxhighlight>


<noinclude>
<noinclude>

Revision as of 03:49, 26 September 2022

This page intention is to become the standard workflow to develop the PKC's solution on Github. Please find the Github Repository at PKC GitHub Repository. All contributor will work on this repository and will use PKC Mediawiki as documentation platform.

Development Procedure

Picture 1:CI/CD Workflow on Github
Picture 1:CI/CD Workflow on Github

The development procedure will follow below process, displayed on PDF. Please clone and create new branch from master for each feature that will be develop, and the review will going through below stages:

  1. [dev], Development stage
  2. [qa], Quality Assurance stage
  3. [production], Production stage, this is the branch that will published and contained the latest stable version of the code.

Please refer to Picture 1 for schema.

To start work on your feature, please follow below code from you localhost.

# for example, you are working on pkc-agent repository
$ git clone https://github.com/Personal-Knowledge-Container/pkc-agent.git

# create new branch, add 'dev' prefix
$ git checkout -b dev-[your-feature-name]
Switched to a new branch ‘dev-[your-feature-name]# git will tell that you are working on your branch
# Then, you can start working on your feature on this branch


References