search

unicef / magicbox

A platform that uses real-time data to inform life-saving humanitarian responses to emergency situations
https://www.unicef.org/innovation/Magicbox
BSD 3-Clause "New" or "Revised" License
86 stars 16 forks source link

Set up GitHub project boards for MagicBox #5

Closed jwflory closed 6 years ago

jwflory commented 6 years ago

Summary

Set up and configure GitHub project boards for MagicBox contributors, to help track progress of work in a kanban-style workflow

Background

GitHub project boards are a kanban-style tool built into all GitHub repositories. Think of it as a Trello replacement that also integrates with GitHub issues and pull requests. This helps clearly document progress on a set of issues and also identify who is working on a task (using issue / PR metadata).

Additionally, project boards come with the added benefit of being publicly viewable, making it easy for anyone to follow along with project status and timeline.

Details

Project boards need to be set up in an easy-to-understand way, so all MagicBox team members understand how to use them effectively, without becoming a burden. Simple automation makes it easier to maintain project boards.

Earlier today, we tried organization project boards (i.e. sharing issues / PRs across multiple repos in a single board), but the project boards seem to private only to organization members. I reached out to GitHub to ask if there is a way to make organization project boards publicly viewable. I believe the transparency that comes with publicly viewable project boards is important.

I am using a project board for community management in this repo, but this could be moved or migrated elsewhere once we determine whether organization boards are a viable option.

Outcome

Project boards that clearly document on-going work, shows available capacity of current team members, and helps eliminate bottlenecks; makes it easier for new contributors to see what tasks are already in progress, need help, or are not being worked on

jwflory commented 6 years ago

Update: We briefly discussed this in our scrum session today. We agreed we would need time to review this as a team either tomorrow or early next week.

jwflory commented 6 years ago

Update: Working on this today. I am now added to the UNICEF GitHub organization, so we can use organization project boards to sync up across multiple projects. I'm planning to demo the method I come up with to @mikefab tomorrow.

jwflory commented 6 years ago

We ran through this together in a call today. We have two organization-level boards to track development and documentation. The community management board still lives and exists in this repo.

It might take a little figuring out, but I think this is "production-ready". 🙂 Closing as complete!