Documentation for PISM, the Parallel Ice Sheet Model

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
committing [2014/05/27 06:51]
Ed Bueler [Best practices] text edits
committing [2017/02/22 06:02]
Ed Bueler
Line 4: Line 4:
    - Create an account on [[http://​github.com]].    - Create an account on [[http://​github.com]].
    - [[http://​help.github.com/​set-up-git-redirect|Set up Git]] on your own system, if it is not already present.    - [[http://​help.github.com/​set-up-git-redirect|Set up Git]] on your own system, if it is not already present.
-   - Send an e-mail to [[help@pism-docs.org]] asking to be added to the "​team"​ of PISM developers. ​ We will make you a member of organization [[https://​github.com/​pism]].+   - Send an e-mail to [[uaf-pism@alaska.edu]] asking to be added to the "​team"​ of PISM developers. ​ We will make you a member of organization [[https://​github.com/​pism]].
    - Being a project member allows you to [[https://​github.com/​pism/​pism/​issues?​milestone=&​sort=created&​direction=desc&​labels=&​state=open|post "​issues"​ at the github host]], which may be labeled as "​bugs",​ "​tasks",​ "​feature requests",​ etc.    - Being a project member allows you to [[https://​github.com/​pism/​pism/​issues?​milestone=&​sort=created&​direction=desc&​labels=&​state=open|post "​issues"​ at the github host]], which may be labeled as "​bugs",​ "​tasks",​ "​feature requests",​ etc.
    - Clone the PISM source code repository using Git, with a URL that includes write permission, and select the dev branch to work on: <​code>​ git clone -b dev git@github.com:​pism/​pism.git pism-dev </​code>​    - Clone the PISM source code repository using Git, with a URL that includes write permission, and select the dev branch to work on: <​code>​ git clone -b dev git@github.com:​pism/​pism.git pism-dev </​code>​
Line 19: Line 19:
 To satisfy our NASA-funded responsibility at UAF, we need to retain some little bit of control. ​ We need PISM to do what we are funded to do.  The following list of "best practices"​ facilitates such minimal control while encouraging healthy development. ​ Perfection on these "​rules"​ is not expected at any time.  Mistakes are //always// forgiven. ​ We are well-protected by version control. To satisfy our NASA-funded responsibility at UAF, we need to retain some little bit of control. ​ We need PISM to do what we are funded to do.  The following list of "best practices"​ facilitates such minimal control while encouraging healthy development. ​ Perfection on these "​rules"​ is not expected at any time.  Mistakes are //always// forgiven. ​ We are well-protected by version control.
  
-   - Non-UAF developers should commit on the ''​dev''​ branch and not on ''​stable''​ branches, because UAF manages stable releases. ​ We do the merge of ''​dev''​ into the next ''​stableX.Y''​ release. ​ If you find a bug in the stable release then [[reporting_bugs|please report it]] and we will fix it at UAF.  Even better, send a pull request if you have fixed it in a fork, or send a patch to [[help@pism-docs.org]].  If a bug exists in ''​dev''​ and you can safely fix it directly, then that is much appreciated.+   - Non-UAF developers should commit on the ''​dev''​ branch and not on ''​stable''​ branches, because UAF manages stable releases. ​ We do the merge of ''​dev''​ into the next ''​stableX.Y''​ release. ​ If you find a bug in the stable release then [[reporting_bugs|please report it]] and we will fix it at UAF.  Even better, send a pull request if you have fixed it in a fork, or send a patch to [[uaf-pism@alaska.edu]].  If a bug exists in ''​dev''​ and you can safely fix it directly, then that is much appreciated.
    - The software tests present in the dev branch are somewhat-thorough regression tests. ​ (They are better than nothing!) ​ Please run them before a commit to minimally check that you have not broken something: <​code>​    - The software tests present in the dev branch are somewhat-thorough regression tests. ​ (They are better than nothing!) ​ Please run them before a commit to minimally check that you have not broken something: <​code>​
      cd 'your build directory'​      cd 'your build directory'​
committing.txt ยท Last modified: 2017/02/22 06:03 by Ed Bueler
© 2020 by PISM | webmaster