{"id":23107516,"url":"https://github.com/pixelmatters/pixelmatters-github-labels","last_synced_at":"2025-04-03T22:43:34.027Z","repository":{"id":97172399,"uuid":"337377496","full_name":"Pixelmatters/pixelmatters-github-labels","owner":"Pixelmatters","description":"Enhance Github labelling system, in a Pixelmatters' way.","archived":false,"fork":false,"pushed_at":"2024-03-01T16:09:39.000Z","size":145,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-12T02:01:48.063Z","etag":null,"topics":["github","labels","pixelmatters"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pixelmatters.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-09T11:07:24.000Z","updated_at":"2024-03-01T16:09:43.000Z","dependencies_parsed_at":"2024-03-01T17:30:30.768Z","dependency_job_id":"b7fa4870-501e-4eb5-a142-104de7e9ffc4","html_url":"https://github.com/Pixelmatters/pixelmatters-github-labels","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pixelmatters%2Fpixelmatters-github-labels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pixelmatters%2Fpixelmatters-github-labels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pixelmatters%2Fpixelmatters-github-labels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pixelmatters%2Fpixelmatters-github-labels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pixelmatters","download_url":"https://codeload.github.com/Pixelmatters/pixelmatters-github-labels/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247092374,"owners_count":20882217,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github","labels","pixelmatters"],"created_at":"2024-12-17T01:14:17.305Z","updated_at":"2025-04-03T22:43:34.009Z","avatar_url":"https://github.com/Pixelmatters.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg width=\"80\" src=\"./img/pixelmatters-logo.jpeg\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./img/pixelmatters-name.svg\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\n    GitHub Labels\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Enhance Github labelling system, in a Pixelmatters' way.\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/Pixelmatters/eslint-config-pixelmatters/blob/master/LICENSE\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"eslint-config-pixelmatters is released under the MIT license.\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/Pixelmatters/eslint-config-pixelmatters/blob/master/CONTRIBUTING.md\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\" alt=\"PRs welcome!\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://twitter.com/intent/follow?screen_name=pixelmatters_\"\u003e\n      \u003cimg src=\"https://img.shields.io/twitter/follow/pixelmatters_.svg?label=Follow%20@pixelmatters_\" alt=\"Follow @pixelmatters_\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n## Why use this\n\nManaging pull requests in a collaborative project can be a bit frustrating. When facing a long list of PRs, usually developers ask themselves:\n- What is this PR/issue about?\n- Did they already tackled the changes that I requested?\n- Which issues/PRs are the most priority?\n- Is this ready for my code review?\n- Can I merge this one?\n\nUnfortunately on GitHub, and other platforms, default labels are usually not the best or the right ones for your collaboration needs. So, we decided to document the solution that we use at Pixelmatters aiming a more efficient PRs management. **You may not know it yet, but we're quite obsessed by the efficiency of our communication and processes.**\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./img/github-labels.png\" width=\"738\"\u003e\n\u003c/p\u003e\n\n## How it works\n\nWe use the following three **three different label categories**. Each issue or pull request can only contain one label of each type:\n\n- **Status** - used to check the state/progress of your work during different stages of development;\n- **Type** - used to check, as the name implies, the type of each issue/PR, for instance, a \"Bug\", \"Feature\", etc;\n- **Priority** - used to differentiate between issues/PR that are most critical to solve. This makes tackling the essential issues a lot easier, especially when you have tons of issues/PR.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./img/feature-label.png\" width=\"200\"\u003e\n\u003c/p\u003e\n\nIt may seem like a small improvement, but when you have around +20 pull requests or so this system can really shine and make Product Owners and Developers' jobs a whole lot easier.\n\n\u003e ❗️ **You must use the recommended colors** so we can get used to those, improving readability.\n\n## How to use it\n\n1. Install `git-labelmaker` globally\n\n    ```bash\n    yarn global add git-labelmaker\n\n    OR\n\n    npm i -g git-labelmaker\n    ```\n\n2. Go into your git repository and run the following command\n\n    ```bash\n    git-labelmaker\n    ```\n\n3. `git-labelmaker` will ask you for a token, that you can get by (the example is for GitHub):\n    1. Clicking your profile picture\n    2. Settings\n    3. Developer settings\n    4. Personal access tokens\n    5. Generate a new token and make sure to provide repo permissions.\n\n        \u003cimg src=\"./img/github-permissions.png\" width=\"500\"\u003e\n\n        Then copy the token (which you can only see at this point) and paste it into the terminal. \n\n    6. If all went well, you'll be greeted with the following menu, where you have to pick *Add Labels From Package.* and point to `pixelmatters-github-labels.json` file in this repository.\n\n        \u003cimg src=\"./img/labelmaker.png\" width=\"500\"\u003e\n\n\u003chr\u003e\n\nInspired by the excellent article [Sane GitHub Labels](https://medium.com/@dave_lunny/sane-github-labels-c5d2e6004b63) from [@Dave Lunny](https://medium.com/@dave_lunny).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpixelmatters%2Fpixelmatters-github-labels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpixelmatters%2Fpixelmatters-github-labels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpixelmatters%2Fpixelmatters-github-labels/lists"}