# PyData NYC Tagging Sprint

The following issue is restricted to folks participating in-person at the PyData New York Sprints on Oct 31st. Eventually we plan to open participation to everyone, but are starting with a small group to work out how to scale this in a managable way.

## Introduction
We're improving the user experience of Matplotlib's [gallery of examples](https://matplotlib.org/stable/gallery/index.html) by implementing tags for better organization and navigability. Over the last few months, we developed [tagging guidelines](https://matplotlib.org/devdocs/devel/tag_guidelines.html) and began to tag some examples. Now we're ready to see what we can do with more brains on the project.

## Participants
Hey folks, thanks for helping us tag our gallery. This sprint has two stages:
* **NO CODE:** Tag gallery examples in our [tagging spreadsheet](https://docs.google.com/spreadsheets/d/1jQvbda6g7P22iKZYelQ0LXF77y7qHeW2yxA5vMDcMos/edit?usp=sharing)
* **LOW CODE (*optional*):** Add tags to gallery examples using the `tag` directive

To participate, please:
* [Sign up for github](https://github.com/signup?)
* **Claim an untagged example:** add your github handle to our [tagging spreadsheet](https://docs.google.com/spreadsheets/d/1jQvbda6g7P22iKZYelQ0LXF77y7qHeW2yxA5vMDcMos/edit?usp=sharing)
* Please do not work on an example that has already been tagged by someone else

### Tag examples
Add tags to the spreadsheet following these instructions:
#### To add a single tag:
1. Add your Github handle to Column K
2. Type the tag you want to add in Column G
#### To add multiple tags (manual method)
1. Add your Github Handle to Column K
2. You can type the tags in manually, just make sure to double check that the formatting is correct. Each tag is in the format `subcategory: tag`, and multiple tags **must be separated by commas**.

### Convert tags to pull request (*optional*)
Please only open pull requests for entries you have tagged, unless you have gotten permission from the person who tagged those entries.

1. Create a fork and development environment as described in our [pull request guide](https://matplotlib.org/devdocs/devel/contribute.html#how-to-contribute)
2. Add tags as described in our [tagging guide](https://matplotlib.org/devdocs/devel/tag_guidelines.html)
3. Follow the rest of the instructions in the [pull request guide](https://matplotlib.org/devdocs/devel/contribute.html#how-to-contribute) to create a pull request
* If you're working on an entry tagged by someone else, add them as a [co-author](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors)
4. Add a link to the PR to the [spreadsheet](https://docs.google.com/spreadsheets/d/1jQvbda6g7P22iKZYelQ0LXF77y7qHeW2yxA5vMDcMos/edit?usp=sharing) entry

### Propose a new tag
During the tagging sprint, you can propose new tags by adding them to the `propose new tags` sheet in the spreadsheet. After the tagging sprint, new tag proposals will new issues. Check the `propose new tags` sheet for instructions and a place for proposed tags.

## Maintainers
Hey folks, thanks for your help! Please add tagging pull requests to the [Gallery Tagging Project](https://github.com/orgs/matplotlib/projects/6). If the pull request needs extra attention, please tag @esibinga, @melissawm or @story645