
============
Developer
============

:term:`Developer` processes :term:`Work Card`s, develops them and deploys them to production.

Those live on the :term:`Work Board`.

Those are the task :term:`Developer` may want to perform. 

------------------------------------
Code review
------------------------------------

Code review ensures the quality of the code and disperses the knowledge about the code and features through the team.

Issuing Pull Request
^^^^^^^^^^^^^^^^^^^^^

.. highlight:: bash

	bb gh pr

This:

#. Inspects current repository for branches
#. Inspects ``Doing`` on the :term:`Work Board` for the current working ticket
  * You should have only one working ticket in ``Doing`` that is assigned only to you
#. Creates a pull request that references the trello card and references the PR on the card as well
#. Moves the card to ``Paused/Waiting``
#. Opens the browser with the PR for further editing/review


Merging Pull Request
^^^^^^^^^^^^^^^^^^^^^

.. highlight:: bash

	bb gh merge https://github.com/apiaryio/apiary/pull/1234

This:

#. Inspects the current repository and the pull request
#. Switches to master and brings it up to date
#. Merges the PR locally and pushes to master
#. Deletes the merged branch from the remote repository/github

TODO:

* Comment the associated Trello card


============
Developer
============

:term:`Developer` processes :term:`Work Card`s, develops them and deploys them to production.

Those live on the :term:`Work Board`.

Those are the task :term:`Developer` may want to perform. 

------------------------------------
Code review
------------------------------------

Code review ensures the quality of the code and disperses the knowledge about the code and features through the team.

Issuing Pull Request
^^^^^^^^^^^^^^^^^^^^^

.. highlight:: bash

	bb gh pr

This:

#. Inspects current repository for branches
#. Inspects ``Doing`` on the :term:`Work Board` for the current working ticket (you should have only one working ticket in ``Doing`` that is assigned only to you)
#. Creates a pull request that references the trello card and references the PR on the card as well
#. Moves the card to ``Paused/Waiting``
#. Opens the browser with the PR for further editing/review


Merging Pull Request
^^^^^^^^^^^^^^^^^^^^^

.. highlight:: bash

	bb gh merge https://github.com/apiaryio/apiary/pull/1234

This:

#. Inspects the current repository and the pull request
#. Switches to master and brings it up to date
#. Merges the PR locally and pushes to master
#. Deletes the merged branch from the remote repository/github

TODO:

* Comment the associated Trello card

Move documentation list item into parenthesis for better readability
Move documentation list item into parenthesis for better readability
