Skip to content
This repository was archived by the owner on Jan 29, 2021. It is now read-only.
/ blazon Public archive

Internal tool to let maintainers create duplicate issues in relevant track repositories.

License

Notifications You must be signed in to change notification settings

exercism/blazon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Blazon

Internal tool to let track maintainers create duplicate issues in all relevant language track repositories.

Installation

If you have Go:

go get -u github.com/exercism/blazon

If not, grab the most recent release.

Configuration

Create a personal api token, giving it the scope "public_repo". Save it to an environment variable named BLAZON_GITHUB_API_TOKEN.

Usage

Run blazon to see the available flags.

Tips

Top Level Issue

Before submitting the blazon issue, make sure that there is an issue that summarizes the problem/solution. If it doesn't already exist, then create one (it might fit into the problem-specifications repository, or the meta repository).

Then include a link to the summary issue in the body of the text for the blazon issue.

This will ensure that the summary issue contains references to each of the individual issues in each of the track repositories. Each of these links will include an icon whose color indicates the status of the issue (open|closed).

This ensures that there is a handy, visible "todo" list that immediately shows the overall status of the effort, and once all of the related links are red, the summary issue can be closed.

Canonical Data

If you're submitting a cross-track issue about an exercise, it is worth checking if there's a JSON file containing the canonical data for the exercise.

If there is no JSON file, then perhaps we need to do a survey first and then create the JSON file before notifying everyone. This would reduce the amount of noise generated if it turns out that the survey uncovers interesting edge cases that the first blazon issue didn't.

If there is a JSON file, then it's worth making sure that it reflects these changes first, so that each language track can reference the canonical data, or (if it has generators) simply regenerate it.

About

Internal tool to let maintainers create duplicate issues in relevant track repositories.

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •