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 by implementing tags for better organization and navigability. Over the last few months, we developed tagging guidelines 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
• LOW CODE (optional): Add tags to gallery examples using the tag directive

To participate, please:

• Sign up for github
• Claim an untagged example: add your github handle to our tagging spreadsheet
  • 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
2. Add tags as described in our tagging guide
3. Follow the rest of the instructions in the pull request guide to create a pull request
   • If you're working on an entry tagged by someone else, add them as a co-author
4. Add a link to the PR to the spreadsheet 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 and milestone for 3.9.0.

If the pull request needs extra attention, please tag @esibinga, @melissawm or @story645