{"id":21496932,"url":"https://github.com/financial-times/origami-labels","last_synced_at":"2025-07-15T19:32:55.467Z","repository":{"id":37872991,"uuid":"247098005","full_name":"Financial-Times/origami-labels","owner":"Financial-Times","description":"GitHub action to sync a repo's issue labels with the standard Origami set","archived":false,"fork":false,"pushed_at":"2024-07-02T14:41:59.000Z","size":2374,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":25,"default_branch":"v1","last_synced_at":"2024-11-22T03:56:00.220Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Financial-Times.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-13T15:03:17.000Z","updated_at":"2024-07-02T14:42:02.000Z","dependencies_parsed_at":"2024-10-25T05:26:56.931Z","dependency_job_id":"b087ea48-3b79-4b93-a4aa-dd6ba674badc","html_url":"https://github.com/Financial-Times/origami-labels","commit_stats":{"total_commits":77,"total_committers":9,"mean_commits":8.555555555555555,"dds":0.6883116883116883,"last_synced_commit":"636666e7aed41945c501b505caeacefceae68193"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Financial-Times%2Forigami-labels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Financial-Times%2Forigami-labels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Financial-Times%2Forigami-labels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Financial-Times%2Forigami-labels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Financial-Times","download_url":"https://codeload.github.com/Financial-Times/origami-labels/tar.gz/refs/heads/v1","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226065215,"owners_count":17568174,"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":[],"created_at":"2024-11-23T16:19:43.912Z","updated_at":"2024-11-23T16:19:44.628Z","avatar_url":"https://github.com/Financial-Times.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Origami Labels\n\nGitHub action to sync a repo's issue labels with the standard Origami set.\n\n\n## Usage\n\nTo use this action, create the following file in your GitHub repo:\n\n```\n.github/workflows/sync-repo-labels.yml\n```\n\n```yml\non: [issues, pull_request]\njobs:\n  sync-labels:\n    runs-on: ubuntu-latest\n    name: Sync repository labels\n    steps:\n      - uses: Financial-Times/origami-labels@v1\n        with:\n          github-token: ${{ secrets.GITHUB_TOKEN }}\n```\n\n:warning: Whenever an issue is opened, the workflow will execute. This overrides all labels in the repository and may result in loss of data if it's run on a repo that isn't owned by Origami.\n\nYou can do this by running the following command from a repo:\n\n```bash\nmkdir -p .github/workflows \u0026\u0026 curl https://raw.githubusercontent.com/Financial-Times/origami-labels/v1/example.yml --output .github/workflows/sync-repo-labels.yml\n```\n\n\n## Labels\n\nYou can find the current labels in [`./labels.js`](labels.js). Edit this file to make changes to Origami's suite of labels.\n\n### Current Labels\n\nLabel|Description|Color|Example\n-----|-----|-----|-----\nblocked|Work blocked by something else|`#CC0000` (crimson)|\u003cimg height=\"25px\" alt=\"label-blocked\" src=\"https://user-images.githubusercontent.com/138944/76612724-c8c00480-6514-11ea-9dee-5e2344d31864.png\"\u003e\nbreaking|Will require a major version bump|`#990F3D` (claret)|\u003cimg height=\"25px\" alt=\"label-breaking\" src=\"https://user-images.githubusercontent.com/138944/76612740-d7a6b700-6514-11ea-9cb2-ecccfa30dc6b.png\"\u003e\nbug|Something isn't working|`#CC0000` (crimson)|\u003cimg height=\"25px\" alt=\"label-bug\" src=\"https://user-images.githubusercontent.com/138944/76612741-d7a6b700-6514-11ea-885a-567d110b9e84.png\"\u003e\naccessibility|An accessibility issue|`#000000` (black)|\u003cimg src=\"https://user-images.githubusercontent.com/178266/102614042-6e02ab80-412b-11eb-9d09-392957cca4ad.png\"\u003e\ncurrent|Used to mark an issue as planned for Origami's current six-week cycle|`#FFB885` (mandarin 60% on white)|\u003cimg height=\"25px\" alt=\"label-current\" src=\"https://user-images.githubusercontent.com/138944/78148389-b9095100-742c-11ea-9ae7-32571eb0a01b.png\"\u003e\nnext|Used to mark an issue to discuss in Origami's next six-week planning session|`#FFCFAD` (mandarin 40% on white)|\u003cimg height=\"25px\" alt=\"label-next\" src=\"https://user-images.githubusercontent.com/178266/94915489-86ecb080-049c-11eb-812e-58b3e829aad0.png\"\u003e\ndependencies|This is maintenance work relating to dependency bumps|`#FFEC1A` (lemon)|\u003cimg height=\"25px\" alt=\"label-dependencies\" src=\"https://user-images.githubusercontent.com/138944/76756794-4fc3e580-677e-11ea-9364-c16c3231e3e4.png\"\u003e\ndiscussion|General discussion including support questions|`#FF7FAA` (candy)|\u003cimg height=\"25px\" alt=\"label-discussion\" src=\"https://user-images.githubusercontent.com/138944/76612742-d83f4d80-6514-11ea-9a2e-1d4b3b3eec8d.png\"\u003e\ndocumentation|Improvements or additions to documentation|`#CCE6FF` (sky)|\u003cimg height=\"25px\" alt=\"label-documentation\" src=\"https://user-images.githubusercontent.com/138944/76612743-d83f4d80-6514-11ea-8d29-cb9ef62751cf.png\"\u003e\nduplicate|This issue or pull request already exists|`#CCC1B7` (black-20)|\u003cimg height=\"25px\" alt=\"label-duplicate\" src=\"https://user-images.githubusercontent.com/138944/76612745-d8d7e400-6514-11ea-83fa-66ce584708bf.png\"\u003e\nfeature|New feature request|`#00994D` (jade)|\u003cimg height=\"25px\" alt=\"label-feature\" src=\"https://user-images.githubusercontent.com/138944/76612746-d8d7e400-6514-11ea-910c-bc0a795ab7ae.png\"\u003e\ngood starter issue|Good for newcomers|`#0D7680` (teal)|\u003cimg height=\"25px\" alt=\"label-good-starter-issue\" src=\"https://user-images.githubusercontent.com/138944/76612748-d9707a80-6514-11ea-8a98-5caafa1f6fc2.png\"\u003e\nhelp wanted|We'd appreciate some help with this|`#96CC28` (wasabi)|\u003cimg height=\"25px\" alt=\"label-help-wanted\" src=\"https://user-images.githubusercontent.com/138944/76747988-ef2eab80-6771-11ea-90f0-71ad15530cc9.png\"\u003e\nmaintenance|Technical tasks that might make things better|`#FFEC1A` (lemon)|\u003cimg height=\"25px\" alt=\"label-maintenance\" src=\"https://user-images.githubusercontent.com/138944/76612752-d9707a80-6514-11ea-9af3-d747bc12696d.png\"\u003e\nokr|This issue or pull request helps us meet an OKR|`#0f5499` (oxford)|\u003cimg height=\"25px\" alt=\"label-okr\" src=\"https://user-images.githubusercontent.com/138944/78137047-89eae380-741c-11ea-9443-ff05e14223b4.png\"\u003e\npattern|A new pattern which impacts multiple components|`#ac92b3` (velvet 50% on paper)|\u003cimg height=\"25px\" alt=\"label-proposal\" src=\"https://user-images.githubusercontent.com/10405691/79582009-1951f100-80c3-11ea-9b35-642e4abbbbe9.png\"\u003e\nproposal|A proposed change which requires approval or discussion|`#262a33` (slate)|\u003cimg height=\"25px\" alt=\"label-proposal\" src=\"https://user-images.githubusercontent.com/138944/76612754-da091100-6514-11ea-96b9-2602d529ea4f.png\"\u003e\nsecurity|This includes a security patch|`#CC0000` (crimson)|\u003cimg height=\"25px\" alt=\"label-security\" src=\"https://user-images.githubusercontent.com/138944/76756796-50f51280-677e-11ea-9cc9-e790ecf8f22a.png\"\u003e\nwontfix|This will not be worked on|`#CCC1B7` (black-20)|\u003cimg height=\"25px\" alt=\"label-wontfix\" src=\"https://user-images.githubusercontent.com/138944/76612756-daa1a780-6514-11ea-8091-0509d9e94cac.png\"\u003e\n\n#### Origami-Type Labels\n\nOrigami-type labels will be automatically added to issues based on the Origami manifest contained within the repo. These map to the types defined in the [Origami Manifest Spec](https://origami.ft.com/spec/v1/manifest/#origamitype).\n\nLabel|Description|Color|Example\n-----|-----|-----|-----\n[origamiType]|Relates to an Origami [origamiType]|`#593380` (velvet)|\u003cimg height=\"25px\" alt=\"label-service\" src=\"https://user-images.githubusercontent.com/138944/76617875-19d4f600-651f-11ea-84bb-111122ce9203.png\"\u003e\n\n#### Continuous Delivery Labels\n\nThese labels are used to automate releases.\n\nLabel|Description|Color|Example\n-----|-----|-----|-----\nrelease:major|Add to a PR to trigger a MAJOR version bump when merged|`#990F3D` (claret)|\u003cimg height=\"25px\" alt=\"label-major\" src=\"https://user-images.githubusercontent.com/138944/76637877-6af6e100-6543-11ea-9344-27c71860030b.png\"\u003e\nrelease:minor|Add to a PR to trigger a MINOR version bump when merged|`#00994D` (jade)|\u003cimg height=\"25px\" alt=\"label-minor\" src=\"https://user-images.githubusercontent.com/138944/76637881-6c280e00-6543-11ea-811f-3cca4bc63cf9.png\"\u003e\nrelease:patch|Add to a PR to trigger a PATCH version bump when merged|`#CC0000` (crimson)|\u003cimg height=\"25px\" alt=\"label-patch\" src=\"https://user-images.githubusercontent.com/138944/76637883-6cc0a480-6543-11ea-8fea-11012d88a2b7.png\"\u003e\n\n### Changing a label name\n\nWhen you want to change a label's name, it's very important to add the _old_ label name to the list of aliases for that label. This will ensure that the label is renamed rather than being removed then created. Failing to do this will result in loss of data.\n\n  1. Copy the value of the `name` property and add a new entry in that label's `aliases` array\n  2. Change the `name` property of the label to your new value\n\n### Changing a label description\n\nChange the `description` property for the label you wish to update.\n\n### Changing a label colour\n\nAdd the new color value to the `colors` object. Change the `color` property for the label you wish to update.\n\n\n## Development\n\nWork should be based on the `master` branch, with changes PRed in.\n\nIf your changes are not breaking, merge them into the `v1` branch, and they'll be picked up by every repo running `v1` automatically.\n\nIf your changes ARE breaking, then you should create a `v2` branch based on master and update your chosen repo to use the new workflow.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinancial-times%2Forigami-labels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffinancial-times%2Forigami-labels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinancial-times%2Forigami-labels/lists"}