Github webinars
Tags: github, project, documentation
Published: 2017-12-05 04:49:48

---
title: Github webinars
published: true
description: I watched the latest webinars from Github and here are my notes.
tags: github, project, documentation
---

*[Originally posted on my blog](https://leonardofaria.net/2017/12/04/github-webinars/)*

Many of us use Github daily however we usually don't use all its features. On the latest months, its team released a few webinars about how Github uses Github. More than showing the web interface, they talked about their culture and their workflows. In this post, I'm adding the links to the webinars with a few notes.

### [Communicating with Issues](https://resources.github.com/webcasts/GitHub-communicating-with-issues/)

*   They don’t send email internally and they use repositories for everything
*   They have 688 people and 829 teams - the concept of team here is: by organizational team, by project, by affinity and by location
*   Their projects always have: `README.md`, `CONTRIBUTING.md`, `ROADMAP.md`, `ISSUE_TEMPLATE.md` and `PULL_REQUEST_TEMPLATE.md`
*   In PRs they include a TL,DR (I also do this)
*   It is possible to create accordions / dropdown in Markdown - [example](https://speakerdeck.com/crichid/how-github-uses-github-communicating-with-issues?slide=38)

### [Communicating with remote teams](https://resources.github.com/webcasts/GitHub-communicating-with-remote-teams/)

*   “Remote” is not a good word and they prefer using the term “Distributed” - which I also like. Like [Thinkific](https://www.thinkific.com), they have weekly radars and team stand-ups. It is interesting to mention they use their own Github to handle projects, instead of using a project-specific tool like Jira or Asana. Even their one-on-ones are stored in repositories
*   They mentioned [Hubot](https://github.com/topics/hubot) - a bot system with several plugins
*   For video calls, they use zoom - for all meetings they book they also add a zoom link (we kind of do the same with Google Meet)

### [Managing your teams](https://resources.github.com/webcasts/GitHub-managing-your-teams/)

*   They show the project's functionality inside Github. It is a Kanban/Trello style project tool with the advantage of being integrated with Github. To be honest, I never noticed the Project feature but after this webinar, I started using in a pet-project
*   They show [Probot](https://probot.github.io/) - it’s an open-source bot created by GH employees
*   They show [Task Lists](https://help.github.com/articles/about-task-lists/#creating-task-lists) (markdown trick)

### [Managing your projects](https://resources.github.com/webcasts/GitHub-managing-your-projects/)

*   This one covers pretty much the project feature that Github offers (similar to the previous one). It is cool because projects are connected to the repo and they show how to use Issues, PRs and Milestones together. For one moment I thought why we don’t use Github in the company but I remembered how much would cost per user so I am not sure if it is a good idea.
*   Github has [saved replies](https://github.com/blog/2135-saved-replies) that can be used in PR’s and Issues. Pretty handy.

### [Writing documentation for your projects](https://resources.github.com/webcasts/GitHub-writing-documentation-for-your-projects/)

*   They show [Read the Docs](https://docs.readthedocs.io/en/latest/index.html)
*   They remember that documentation is part of a process, don't give this to only one person.
*   They share some thoughts about how to write good documentation.

If you like my notes you may want to watch the videos :)