This guide helps you get started with filter setup for GitHub using Gmail. While this is a generally useful topic for other projects, Istio will be the focus of these filter creation rules. This is just one developer's filter list - you may have your own. If you wish to add your own, please improve the wiki by adding a section on your github gmail filters. If you wish to explain your filtering approach or workflow feel free to expand this document with your name and your specific filters.

• sdake gmail filters

My gmail filters are designed to prioritize:

1. mentions
2. reviews
3. then keep a record of all github activity. As I am a maintainer for environments and T&R, any activity that affects these two working groups will come in as a review. If I am specifically tagged by @sdake this will create a mention, and the mention will be targeted to my mentions folder.

As mentions are generally higher priority and indciate I either wasn't paying close enough attention or my attention is immediately needed, I keep a close eye on my mentions folder in gmail. For reviews, I also keep a close eye. If, after processing these two folders and everything is read, I can take a look at the rest of the project activity to see what is happening.

• Select the gear icon.
• Select See all settings.
• Selecct Filters and Blocked Addresses.
• Select Create a new filter. You can use CTRL-F to find the string - it is not obvious to find if you already have filters.

For each filter, I use the github To field to determine the category for the filter.

Set the following fields in the window that appears when you select Create a new filter.

• To: mention@noreply.github.com.
• Has the words: list:(*.istio.github.com)

Select Continue. Select the following checkboxes:

• Skip the Inbox (Archive it)
• Star it (this is personal preference depending on how you use stars)
• Apply the label: New Label (create a label called github-istio-mentions)
• Never send to spam.
• Also apply filter to matching conversations. (this will apply the labels and refilter your inbox)

Set the following fields in the window that appears when you select Create a new filter.

• To: review_requested@noreply.github.com.
• Has the words: list:(*.istio.github.com)

Select Continue. Select the following checkboxes:

• Skip the Inbox (Archive it)
• Star it (this is personal preference depending on how you use stars)
• Apply the label: New Label (create a label called github-istio-reviews)
• Never send to spam.
• Also apply filter to matching conversations. (this will apply the labels and refilter your inbox)

Set the following fields in the window that appears when you select Create a new filter.

• Has the words: list:(*.istio.github.com)

Select Continue. Select the following checkboxes:

• Skip the Inbox (Archive it)
• Star it (this is personal preference depending on how you use stars)
• Apply the label: New Label (create a label called github-istio)
• Never send to spam.
• Also apply filter to matching conversations. (this will apply the labels and refilter your inbox)

Save the filter.