{"id":15152869,"url":"https://github.com/ipfs/team-mgmt","last_synced_at":"2025-09-30T01:31:16.150Z","repository":{"id":29522015,"uuid":"33060528","full_name":"ipfs/team-mgmt","owner":"ipfs","description":"IPFS Team Planning, Management \u0026 Coordination threads","archived":true,"fork":false,"pushed_at":"2023-01-28T19:07:39.000Z","size":6735,"stargazers_count":267,"open_issues_count":32,"forks_count":97,"subscribers_count":80,"default_branch":"master","last_synced_at":"2024-10-29T12:11:33.667Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/ipfs/team-mgmt/issues","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ipfs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-29T03:49:53.000Z","updated_at":"2024-07-17T09:24:46.000Z","dependencies_parsed_at":"2023-02-15T18:31:17.242Z","dependency_job_id":null,"html_url":"https://github.com/ipfs/team-mgmt","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/ipfs%2Fteam-mgmt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfs%2Fteam-mgmt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfs%2Fteam-mgmt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipfs%2Fteam-mgmt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipfs","download_url":"https://codeload.github.com/ipfs/team-mgmt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222073983,"owners_count":16926419,"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-09-26T16:40:55.063Z","updated_at":"2025-09-30T01:31:15.220Z","avatar_url":"https://github.com/ipfs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\n⚠️ ⚠️ ⚠️  \nMuch of this repo is not accurate to the current state of affairs in 202207.\nUpdates are needed to account for how [IPFS development spans multiple implementations and organizations](https://docs.ipfs.io/basics/ipfs-implementations/).\nFor now, see the [official IPFS community docs](https://docs.ipfs.io/community/) for ways to engage with teams developing IPFS.  \n⚠️ ⚠️ ⚠️\n\n---\n\n# IPFS Team Planning, Management \u0026 Coordination threads\n\n[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](https://protocol.ai)\n[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.io/)\n\n## Repo Index\n\n- [Related Projects](#related-projects)\n- [How We Work Together](#how-we-work-together)\n- [Teams, Roles \u0026 Structures](TEAMS_ROLES_STRUCTURES.md)\n- [Asynchronous Communitication](#asynchronous-communication)\n  - [Project \u0026 Working Groups Roadmaps](#project--working-groups-roadmaps)\n  - [OKR (Objectives \u0026 Key Results)](#okrs)\n  - [Tracking Repo Activity](#tracking-repo-activity)\n- [Synchronous Communication](#synchronous-communication)\n  - [Monthly Community Meetup](#monthly-community-meetup)\n  - [Calendar](#calendar)\n  - [Chat](#chat)\n  - [Working Hours](#working-hours)\n  - [Timezone: UTC](#timezone-utc)\n- [Tools \u0026 Tutorials](#tools--tutorials)\n  - [Lead Maintainer Protocol](LEAD_MAINTAINER_PROTOCOL.md)\n  - [Host a Call](HOST_A_CALL.md)\n  - [Coordination Toolkit](TEAM_COORDINATION_TOOLKIT.md)\n  - [How to create a Roadmap](ROADMAP_HOW_TO.md)\n  - [Resources for Distributed Teams](DISTRIBUTED_TEAMS.md)\n  - [Zoom](#zoom)\n- [Contribute](#contribute)\n- [License](#license)\n\n## Related Projects\n\nIPFS is built on several related projects that each have their own planning:\n\n- [IPLD](https://github.com/ipld/team-mgmt)\n- [libp2p](https://github.com/libp2p/team-mgmt)\n\n## How We Work Together\n\nWe deliberately designed an organizational process that is very flexible, enabling each team to design a coordination strategy that suits their project needs, while keeping a baseline for team-wide coordination around project-wide planning.\n\nYou might hear terms such as \"Working Group Roadmap\", \"Project Roadmap\", \"OKRs\", \"Metrics\" used often. If you are puzzled about how these all fit together and what is the best resource to look at, we've created the following diagram to illustrate how all of these fit together for the IPFS org.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/ipfs/team-mgmt/master/img/ipfs-org-planning-one-picture.jpeg\" alt=\"IPFS planning in one picture\" width=\"450\" /\u003e\n\u003c/p\u003e\n\n**If you are new around here, the best way to get onboarded is to focus on the \"Day to Day Operations\" as it will help you meet the Working Groups, understand what their top priorities are, and quickly identify where you can contribute**. Later, you can go through all the Quarterly OKRs and Yearly Planning so that you understand fully the decisions you see being made.\n\nYou can also learn more about operating in Distributed Teams at our ['Distributed Teams' Document](DISTRIBUTED_TEAMS.md), containing resources on tools, decision making, process and more. We have been gathering, reviewing, discussing and experimenting with many overtime and will continue to do so as we find new needs.\n\n## Teams\n\nMeet the current Working and Research Groups at the [TEAMS_ROLES_STRUCTURES](TEAMS_ROLES_STRUCTURES.md) document.\n\n## Asynchronous Communication\n\nAs an organization that operates at a planetary scale with multiple people from different timezones and schedules, we value tremendously the benefits of Asynchronous Communication. The art of writing things down for our future selves or future contributors is one of the key reasons that enables [so many contributors](https://github.com/ipfs/contributors-hex-grid#big-grid) to participate in the large endeavour of Distributing the Web with the IPFS Project.\n\nSome golden recommendations:\n- Prefer opening an issue vs. sending a DM\n- If you find documentation missing, treat it as a bug - once you get your answer, contribute it so that it benefits others\n- Use synchronous time wisely (only if needed), and convert any output into an artifact that can be used by others (avoid Tribal Knowledge)\n\n### Planning\n\nThe IPFS Project \u0026 Working Group Roadmaps serve as the north star for our quarterly planning process and long term achievement of our mission goals. You can find these roadmaps at https://github.com/ipfs/roadmap.\n\nThe IPFS workgroups plan and measure impact on a quarterly basis using OKRs - [learn more here](OKR).\n\n## Synchronous Communication\n\nSynchronous Communication is phenomenal to transfer memes rapidly, clarify any outstanding questions, deep dive into hard topics together, get to know each other better and develop trust. The main pain point with Synchronous Communication is that if you were not present, you might miss out on important information that is relevant to you and your project. To overcome this limitation, **a core competency of the IPFS Org as a whole is to be stellar at taking notes and creating artifacts that represent any decision/announcement made during those synchronous conversations**. The corollary being: if it ain't written down and broadcasted, it didn't happen.\n\nYou can find the schedule for meetings of each of the IPFS Working Groups, Special Interest Groups, and Related Projects in the [TEAMS_ROLES_STRUCTURES](TEAMS_ROLES_STRUCTURES.md) document, as well as in the community calendar below.\n\n### Monthly Community Meetup\n\nWe host a monthly community meetup for builders across the IPFS ecosystem to present on notable improvements and updates. It's a great 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. You can sign up to share a lightning talk or demo in the meetup invite ([example](https://www.meetup.com/San-Francisco-IPFS/events/271042788/)). Newcomers are very welcome.\n\nYou can find recordings of past meetups on [Youtube](https://www.youtube.com/channel/UCdjsUXJ3QawK4O5L1kqqsew/):\n[![image](https://user-images.githubusercontent.com/618519/90301692-46869400-de56-11ea-9a2a-e0debb214f75.png)](https://www.youtube.com/playlist?list=PLuhRWgmPaHtToVYaDkd6ZTwB2Lo30s1vB)\n\n\n### Calendar\n\nYou can view all IPFS-related calls and events on the [IPFS Community Calendar](https://calendar.google.com/calendar/embed?src=ipfs.io_eal36ugu5e75s207gfjcu0ae84@group.calendar.google.com\u0026ctz=UTC).\n\n\u003ciframe src=\"https://calendar.google.com/calendar/embed?src=ipfs.io_eal36ugu5e75s207gfjcu0ae84%40group.calendar.google.com\u0026ctz=America%2FDenver\" style=\"border: 0\" width=\"800\" height=\"600\" frameborder=\"0\" scrolling=\"no\"\u003e\u003c/iframe\u003e\n\n### Chat\n\nWe hangout on IRC for lots of Dev Chat. You can find us on Freenode on the following channels:\n\n- #ipfs\n- #ipfs-dev\n- #ipfs-cluster\n- #ipfs-gui\n- #ipfs-in-web-browsers\n- #ipfs-project\n- #ipfs-infrastructure\n- #ipfs-package-managers\n- #ipfs-pinbot\n- #gx\n- #libp2p\n- #ipld\n\nYou can also access these channels through the [Matrix IRC Bridge](https://riot.im/app/#/group/+ipfs:matrix.org)\n\n### Working Hours\n\nAs the IPFS team is all over the world, we've picked a set of \"working hours\" during which we can overlap. The hours are:\n\n```\n16:00-19:00 Z/UTC daily or\n18:00-21:00 CEST daily or\n12:00-15:00 EST daily or\n09:00-12:00 PDT daily\n```\n\nWe aim to be available during these hours. Your mileage may vary.\n\n## Timezone: `UTC`\n\nAll of our times are set according to the **UTC** timezone (or should be). This is much easier than adjusting times manually to accommodate 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.\n\n## Tools \u0026 Tutorials\n\nTools living in their own documents:\n- [Lead Maintainer Protocol](LEAD_MAINTAINER_PROTOCOL.md)\n- [Host a Call](HOST_A_CALL.md)\n- [Coordination Toolkit](TEAM_COORDINATION_TOOLKIT.md)\n- [How to create a Roadmap](ROADMAP_HOW_TO.md)\n- [Resources for Distributed Teams](DISTRIBUTED_TEAMS.md)\n\n### Zoom\n\nWe use [Zoom](http://zoom.us/) for our community calls. This allows us to stream directly to YouTube, 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.\n\n**Note:** Screen Sharing in Zoom under X11 requires compositor. Users of minimalist tiling window managers (i3, awesome, dwm)  will share a \"black screen\" by default. The fix is to use third-party compositor, eg. [Compton](https://github.com/chjj/compton).\n\n## Contribute\n\nFeel free to join in. All welcome. Open an [issue](https://github.com/ipfs/pm/issues)!\n\nThis repository and all of our calls fall under the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).\n\n[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)\n\n## License\n\n[CC-BY-SA](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipfs%2Fteam-mgmt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipfs%2Fteam-mgmt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipfs%2Fteam-mgmt/lists"}