===========================
Setup git & Commit Messages
===========================

.. image:: ./_assets/os_background.png
   :class: fill
   :width: 100%

Learning Exercise
=================

* Open the `Setup and Learn GIT
  <https://docs.openstack.org/contributors/common/git.html>`_ section
  of the Contributor Guide
* Read the material
* Ask the mentors questions
* Get ready to go through the exercises

Exercise 1
==========

- Configure your workspace
    - ``git config``
    - install git review

Exercise 2
==========

Write a summary line for each bug, blueprint, and story you created
during our task tracking exercises.

Share them in our IRC channel.

Exercise 3
==========

Write a commit message body to expand on two of the  summary
lines you just wrote. Feel free to make up details to make the
context more realistic.

Share them  in IRC.


Exercise 4
==========

Put the pieces together and finish your commit message! Make sure to include
the summary line, body, and the required external references along with any
optional external references you think it may benefit from.

Share the commit message with someone sitting next to you. Give them
feedback on their commit messages.