Skip to content

Commit

Permalink
Merge branch 'dev' into naive-tides
Browse files Browse the repository at this point in the history
  • Loading branch information
jeffriley committed Nov 20, 2023
2 parents bd107b9 + 2e128eb commit b0d9242
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 8 deletions.
17 changes: 10 additions & 7 deletions online-docs/pages/Getting started/dev-git-workflow.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Contents of this document
`Day to Day Commands <#day-to-day-commands>`__


`Lifetime of a Project <#lifetime-of-a-project>`__
`Lifetime of a New Feature <#lifetime-of-a-new-feature>`__


`COMPAS Git Workflow <#the-compas-git-workflow>`__
Expand All @@ -27,7 +27,7 @@ Contents of this document


Introduction
============
------------

Git & Github for COMPAS developers

Expand Down Expand Up @@ -117,7 +117,7 @@ which is in common use in industry.


Getting Set Up
==============
--------------

**Step-by-step directions for how to configure your local and remote git
repositories**
Expand Down Expand Up @@ -215,6 +215,7 @@ homepage <https://compas.science/>`__ for an up-to-date list).


Fork the main repo
------------------


As a COMPAS developer, you are highly encouraged to create your own
Expand Down Expand Up @@ -262,7 +263,7 @@ The ``<fork-nickname>`` is your choice, but should be informative, e.g


Day to Day commands
===================
-------------------

Basic commands for navigating local git

Expand Down Expand Up @@ -461,6 +462,7 @@ preferred text editor.


Deleting branches
-----------------


You should become comfortable deleting branches, or else your repos
Expand Down Expand Up @@ -607,6 +609,7 @@ which will have an output that looks similar to:


git pull
--------


If you have a branch which is "behind" the remote branch it is tracking
Expand Down Expand Up @@ -697,7 +700,7 @@ called the "upstream" branch) with:


Lifetime of a New Feature
=========================
-------------------------

New feature branches

Expand Down Expand Up @@ -808,7 +811,7 @@ before accepting it, so keep an eye on the pull request conversation.


The COMPAS Git Workflow
=======================
-----------------------

The above sections go over many of the available git commands that you
might find useful.
Expand Down Expand Up @@ -868,7 +871,7 @@ comparisons of key plots from different papers.


Terminology
===========
-----------

- **Commit**: A single commit records a collection of edits to one or
more files, with an associated commit message.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ specify the values of the program options.

An example Python script is provided in the COMPAS suite on github: ``runSubmit.py``. Additionally, the default COMPAS options are specified on ``compasConfigDefault.yaml``. Users should copy the ``runSubmit.py`` and ``runSubmit.py`` scripts and modify the ``compasConfigDefault.yaml`` copy to match their experimental requirements. Refer to the :doc:`Getting started guide <../../Getting started/getting-started>` for more details.

To run COMPAS via Python using the ``runSubmit.py`` script provided, set the shell environment variable ``COMPAS-ROOT-DIR``
To run COMPAS via Python using the ``runSubmit.py`` script provided, set the shell environment variable ``COMPAS_ROOT_DIR``
to the parent directory of the directory in which the COMPAS executable resides, then type `python /path-to-runSubmit/runSubmit.py`.
For example, for Ubuntu Linux, type::

Expand Down

0 comments on commit b0d9242

Please sign in to comment.