Planning and Management threads for the IPFS Project
JavaScript
Clone or download

README.md

IPFS Project Management & Coordination

tl:dr: We have a weekly, all-hands call on Mondays. The time, date and other info for each week's call is announced in an issue in this repository. Propose agenda items for the call by commenting on the issue!

Table of Contents

How We Work

We use a loose agile approach, breaking our work into weekly sprints. Here are some things that are good to know:

  • Every Monday we have our team sync calls. The most important call is the all-hands call; we try to keep this short, it has an agenda, and anyone (including you) can propose an agenda item for it.
  • We create a "sprint issue" for each sprint. That is where we put all the information about the week's calls. That's also where the notes from that week's calls accumulate.
  • There are some project-specific sprint discussions after the all-hands call. You're welcome to go to those, too. For more info about these calls, read the sprint discussions section below.
  • You do not have to follow all of the project-specific discusions. They can be very detailed. Only go to ones you want to go to. We post the notes (such as they are) in the sprint issue in this repository afterwards.
  • If you have a topic to discuss or have done work that you want to tell everyone about, propose the agenda item my adding a comment on that week's sprint issue.

You can also find a list of Distributed Teams resources on tools, decision making, process, etc, that we have been gathering, reviewing, discussing and experimenting with at distributed-teams page.

Weekly All Hands

  • When: Every Monday, see calendar.
  • How: This takes place synchronously using Zoom.
  • Length: 30 minutes.

We host an IPFS All Hands Call every Monday. This is a regular and reliable call where everyone who's working on any repository under the IPFS umbrella checks in and has a chance to either call attention to particular items, to make announcements, or to seek discussion of a topic. It's also a way for casual followers to get a high-level update on the pulse of the IPFS projects without having to follow all of the sprint calls. Newcomers are very welcome.

If you are interested in participating, please join us on Zoom.

You can find recordings of the previous IPFS All Hands on a Youtube playlist on the IPFS channel

This calendar an other IPFS Community calls are tracked on the IPFS Community Calendar

Schedule

The schedule for the sprint discussions for each week is on the corresponding ticket (aka "sprint issue") for that week's sprint. It's also in the IPFS community calendar.

Zoom

We use Zoom for our community calls. This allows us to stream directly to YouTube (currently under maintenance), and to have calls with more than 25 users. Zoom may require a download before you are able to join. If you click on a Zoom link to a meeting room, it will automatically suggest the software to download. Please let us know if you have any issues with Zoom.

Note: Screen Sharing in Zoom under X11 requires compositor. Users of minimalist tilling window managers (i3, awesome, dwm) will share a "black screen" by default. The fix is to use third-party compositor, eg. Compton.

Timezone: UTC

All of our times are set according to the UTC timezone (or should be). This is much easier than adjusting times manually to accomodate different time zones, for a distributed team. If our calendar's location is set to Reykjavík, Iceland, it is because Iceland is always on UTC time. It is recommended that you know your timezone's difference from UTC for ease of scheduling. Sites like http://everytimezone.com can help with this..

Moderators and Notetakers

The sprint-helper rotates down from the list in templates/all-hands-facilitators.json, assigning one person to moderate and another to take notes.

Moderating
  1. Record.
    • Ask that someone records the call.
  2. Welcome
    • Welcome Attendees & state the date. ("Hello, and welcome to the IPFS all hands call for ...")
  3. Introductions
    • Is there anyone new to the project or the call?
    • This gives the Notetaker time to add Agenda & Demo Items.
  4. Agenda & Demo items.
    • Announce the Item and presenter name.
      • If an individual is presenting many items, switch it up and give them a breather.
        • i.e. don't make one person talk for 3 straight bullet points ( unless they want to :] ).
    • Prompt for questions at the end of each item.
      • The Moderator or the Presenter may call on people with hands raised.
  5. Announcements
    • For anything not covered in the Agenda or Demo items - Get your word out!
  6. Questions
    • For anything not covered in the Agenda or Demo items - Ask away!
  7. Conclude the call & thank the Attendees ("This concludes the IPFS all hands call for ..., thanks everyone, see you next week!")
Notes

We use hackmd.io for taking notes. Our default setting for notes is 'Editable' - you may need to sign in with your GitHub account in order to edit a document. This ensures that we know who is setting in, without the significant overhead of making a different account somewhere else.

Working Hours

As the IPFS team is all over the world, we've picked a set of "working hours" during which we can overlap. The hours are:

16:00-19:00 Z/UTC daily or
18:00-21:00 CEST daily or
12:00-15:00 EST daily or
09:00-12:00 PDT daily

We aim to be available during these hours. Your mileage may vary.

Contribute

Feel free to join in. All welcome. Open an issue!

This repository and all of our sprint calls fall under the IPFS Code of Conduct.

License

CC-BY-SA