Skip to content

Latest commit

 

History

History
93 lines (56 loc) · 4.23 KB

CONTRIBUTING.md

File metadata and controls

93 lines (56 loc) · 4.23 KB
Raw

Contributing

From opening a bug report to creating a pull request: every contribution is appreciated and welcome.

If you're planning to implement a new feature or change this repository, please create an issue first. This way we can ensure that your precious work is not in vain.

Quick start for contributing new application

Below is the steps for contributing new application:

  1. Create issue by template New docker compose request
  2. Waiting for Maintainers/owner Assessment until it is completed.
  3. Install Websoft9 at your server or apply online development account from Websoft9
  4. SSH to develoment host machine and running below command 
    docker exec -it websoft9-apphub bash /websoft9/script/update_zip.sh --channel dev --package_name "media-dev.zip" --sync_to "/websoft9/media" && docker exec -it websoft9-apphub bash /websoft9/script/update_zip.sh --channel dev --package_name "library-dev.zip" --sync_to "/websoft9/library"
  5. Login to Websoft9 Console and install this application from App Store
  6. Develop and test it by App compose at Websoft9 Console
  7. Complete your issue checklist
  8. Docker exec websoft9-apphub container and pull request to repository 
    # sample for your, --appid get from Websoft9 Console, it not appname
docker exec -it websoft9-apphub  apphub commit --appid "wordpress_o2qjz" --github_token "yourgithubtoken"

Process diagram

Bug report flow as following:

Alt text

Feature request flow as following:

Alt text

Development Specification

If you want to start to develop this repository, it is very useful for you to read the develop documentation

Branch

This repository have these branchs:

  • dev branch: Contributor only allow to fork dev branch and pull request for it.
  • main branch: It is expected to contain code that is stable and ready for deployment.

Maintainers/owner don't accept any pr to main branch from developer directly.

Pull request

Pull request let you tell others about changes you've pushed to a branch in a repository on GitHub.

When is PR produced?

  • Contributor commit to dev branch

How to deal with PR?

  1. pull request reviews
  2. Merge RP and CI/CD for it

DevOps principle

DevOps thinks the same way 5m1e for manufacturing companies

We follow the development principle of minimization, rapid release

Version

Use [major].[minor].[patch] for version serial number and version.json for version dependencies

Artifact

Websoft9 use below Artifact for different usage:

Tags

  • Type tags: RRD, Bug, enhancement, Documetation
  • Stages Tags: S-develop, S-fixed and all tags started with S-

WorkFlow

Websoft9 use the Github flow for development collaboration

licensing

See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.

We may ask you to sign a Contributor License Agreement (CLA) for larger changes.