Skip to content

Latest commit

 

History

History
71 lines (51 loc) · 2.73 KB

CONTRIBUTING.md

File metadata and controls

71 lines (51 loc) · 2.73 KB

Atlas Contributing Guide

Welcome to create Pull Requests or open Issues for bugfix, doc, example, suggestion and anything.

Branch Management

master
 ↑
dev         <--- PR(hotfix/typo/3rd-PR)
 ↑ PR
{domain}-feature-{date}

Atlas Branches

  1. master branch 0. master is the latest (pre-)release branch.
  2. dev branch 0. dev is the stable developing branch. Github Release is used to publish a (pre-)release version to master branch. 0. It's RECOMMENDED to commit hotfix (like typo) or feature PR to dev.
  3. {domain}-feature-{date} branch 0. The branch for a developing iteration, e.g. core-feature-20170118 is an atlas-core developing iteration which is done at 2017.01.18. {domain} consists of core, update, plugin and aapt. 0. DO NOT commit any PR to such a branch.

Branch Name

{module}-{action}-{shortName}
  • {module}, see commit log module
  • {action}
    • feature: checkout from {module} and merge to {module} later. If {module} not exists, merge to dev
    • bugfix: like feature, for bugfix only
    • hotfix: checkout from master or release tag, merge to master and {module} later. If {module} not exists, merge to dev

for example:

  • core-bugfix-memory
  • plugin-feature-redex
  • update-hotfix-sequence

Commit Log

[{module}] {description}
  • {module}
    • Including: atlas-core, atlas-aapt, atlas-update, atlas-gradle-plugin, atlas-doc, atlas-website, atlas-demo, test, all
  • {description}
    • It's RECOMMENDED to close issue with syntax close #66 or fix #66, see the doc for more detail. It's useful for responding issues.

for example:

  • [all] close #66, add refreshing for memory
  • [atlas-doc] fix #68, update some instruction
  • [atlas-demo] remove abc

Pull Request

Create Pull Requests.

Contributor License Agreement

In order to contribute code to Atlas, you (or the legal entity you represent) must sign the Contributor License Agreement (CLA).

You can read and sign the Alibaba CLA online.

For CLA assistant service works properly, please make sure you have added email address that your commits linked to GitHub account.

Please read How to setting your Email address in Git and How to adding an email address to your GitHub Account.