.. Say It With Bots! GitHub App Tutorial documentation master file, created by
   sphinx-quickstart on Sun Apr 19 09:56:16 2020.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Say It With Bots!
=================

This tutorial was prepared for PyCon US 2020. You're free to follow along from
whereever you are.

This documentation lives at: https://github-app-tutorial.readthedocs.io/

.. toctree::
   :maxdepth: 2
   :caption: Contents:


Welcoming Contributions to Your Project
---------------------------------------

In this tutorial we'll be building a GitHub bot that will automatically
greet contributors to your project. The bot will be built as a GitHub App which
can then be installed to your GitHub repositories.

We will be building a GitHub bot that can:

- say thanks to the maintainer who installed your bot

- say thanks to new contributors who made pull requests to your repository

About me
--------

My name is Mariatta. I live in Vancouver, Canada where I work as a Software Engineer
for Zapier. In my free time, I help with PyLadies globally and locally in Vancouver,
I'm one of the co-founders of PyCascades conference, and I also contribute to open source.

I'm a Python Core Developer. I help maintain Core Python's GitHub bots:
`bedevere <https://github.com/python/bedevere>`_ and
`miss-islington <https://github.com/miss-islington>`_.

In this tutorial, we'll be using the same tools and technologies used by Core Python's
team to build their bots.

If you have any feedback or questions about this tutorial, please `file an issue <https://github.com/Mariatta/github-app-tutorial/issues/new>`_.

- E-mail: mariatta@python.org
- Twitter: `@mariatta <https://twitter.com/mariatta>`_
- `Mariatta on GitHub <https://github.com/mariatta>`_
- `Sponsor Mariatta <https://github.com/sponsors/Mariatta>`_

Stay in touch
-------------

I love hearing how you did! If you had taken this tutorial, learned something new
from it, or if you've built something cool after this tutorial, I'd love to hear
about it. You can share it with me either through twitter, email, or even as
an issue on GitHub.


Code of Conduct
===============

`PyCon US Code of Conduct <https://us.pycon.org/2020/about/code-of-conduct/>`_ applies
and will be enforced.

License
=======

`CC-BY-SA 4.0 <https://creativecommons.org/licenses/by-sa/4.0/>`_.

Agenda
======

.. toctree::
   :titlesonly:


   preparation
   why-github-bots
   why-gidgethub
   resources
   gh-api-cmd-line
   creating-github-app
   responding-to-webhook
   whats-next
   git-basics