Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ipfs/community

Discussion and documentation on community practices
https://github.com/ipfs/community

Last synced: about 1 month ago
JSON representation

Discussion and documentation on community practices

Host: GitHub
URL: https://github.com/ipfs/community
Owner: ipfs
License: mit
Created: 2015-03-19T08:25:03.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-09-02T12:11:31.000Z (3 months ago)
Last Synced: 2024-10-02T15:58:19.615Z (about 2 months ago)
Language: Shell
Homepage: https://docs.ipfs.tech/community/
Size: 4.12 MB
Stars: 416
Watchers: 86
Forks: 226
Open Issues: 59
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: code-of-conduct-for-events.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md

Awesome Lists containing this project

awesome-ipfs - GitHub: IPFS Community - The GitHub organization for IPFS projects and resources. (Community and Forums)
awesome-ipfs - GitHub: IPFS Community - The GitHub organization for IPFS projects and resources. (Community and Forums)

README

        ---

⚠️ ⚠️ ⚠️  

Much of this repo - including this readme - is not accurate to the current state of affairs in 202211.

We will be pruning/archiving old content in 2022Q4.

In the interim, the [official IPFS community docs](https://docs.ipfs.io/community/) have relevant ways to engage with the community.

---

# Community

[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](http://ipn.io)

[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](http://ipfs.io/)

[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)

IPFS Community Processes and Resources. 

## Table of Contents

- [About](#about)

- [People](#people)

- [Contributing Guidelines](#contributing-guidelines)

- Events

  - [IPFS Meetups](#ipfs-meetups)

  - [ProtoSchool Workshops](#protoschool-workshops)

  - [IPFS Event Materials](#ipfs-event-materials)

  - [Community Calendar](#community-calendar)

- [Contribute](#contribute)

- [Ecosystem Projects](#ecosystem-projects)

- [License](#license)

## About

The IPFS community is growing, and already has many resources. We ought to maintain them, build more, and improve all the things. This repository is for meta, non-code discussions (in the [issues](issues)) and for documents used by multiple repositories, such as the various Contributing guidelines.

**NOTE:** If you're interested in discussing code, jumping on our community calls, or talking to developers about our overall project management, go to [ipfs/team-mgmt](https://github.com/ipfs/team-mgmt). You can also open issues in specific repositories (like [Kubo](https://github.com/ipfs/kubo)), and come talk to us on [Forums and Chat](https://docs.ipfs.io/community/).

Our goals here are to work on resources that help us with:

- **Building and Maintaining [Community Infrastructure](https://github.com/ipfs/infrastructure)**

  - Public Gateways

  - Testing + CI Services

  - Websites

  - Communication Channels

- **Improving documentation of various projects**

  - Docs on the repos

  - [Docs on the websites](https://ipfs.io/docs)

  - [Examples](https://ipfs.io/docs/examples)

  - Demos

  - [Papers to read to understand IPFS](https://github.com/ipfs/reading-list)

- **Making it easy to jump in and participate**

  - Improving documentation for users

  - Improving issues for collaborators

  - Adding papers to the [Understanding IPFS Reading List](https://github.com/ipfs/reading-list)

- **Keeping the Community Informed and Engaged**

  - Community Resources - https://docs.ipfs.io/community

  - Discussion Forums - https://discuss.ipfs.io/

  - Blog - https://blog.ipfs.io

  - Twitter - [@IPFS](https://twitter.com/IPFS)

## People

IPFS is an open source project with a large and open community. Listing out all the names of the contributors would result in a very long list, so we made a very large hex grid instead!

[![](https://ipfs.io/ipfs/QmPNkiTxa8V2vaRLmTBJte5RZzkNYjiUYnvht6BUpqs8au/ipfs-people.jpg)](https://ipfs.io/ipfs/QmVNsFGDQPa2kJHUHxQmYJddzwDZdX2twpvwFF2jaChAix/)

The grid keeps growing, find the latest always at the [Contributors Hex Grid repo](https://github.com/ipfs/contributors-hex-grid#interplanetary-contributors-webpage).

## Contributing Guidelines

- [Contributing Guidelines](./CONTRIBUTING.md)

- [Contributing Guidelines for JavaScript Projects](./CONTRIBUTING_JS.md)

- [Contributing Guidelines for Golang Projects](./CONTRIBUTING_GO.md)

- [Code of Conduct](./code-of-conduct.md).

## Events

### IPFS Meetups

There are several community meetups in different areas of the world, organized by the IPFS developers and enthusiasts. Everyone is welcome to participate in their local meetup or be the ones organizing one.

Find the list at:

- [This repo](https://github.com/ipfs/community/issues?q=is%3Aissue+is%3Aopen+label%3Ameetup)

- [Meetup.com](https://meetup.com/pro/ipfs)

### ProtoSchool Workshops

[ProtoSchool](https://proto.school) is a community-driven open source project dedicated to making it easy to get started with decentralized web technologies like IPFS through [interactive online tutorials](https://proto.school/#/tutorials) and local learning events led by community groups around the world. To locate a workshop near you, check out our [event listings](https://proto.school/#/events). Don't see a ProtoSchool workshop in your neighborhood? [Host your own!](https://proto.school/#/host)

### IPFS Event Materials

Want to host an event to share IPFS with others, or bring IPFS to another event? Feel free to use these materials to make your event(s) awesome! Everything here is [Creative Commons 4.0](https://creativecommons.org/licenses/by-sa/4.0/) - so feel free to adapt or remix!

- **How IPFS Works Overview:** [@stebalien](http://github.com/stebalien) created a great presentation template for "[How IPFS Works (approximately)](https://docs.google.com/presentation/d/1wyrTNTERJV23R7PyLrNloBauygdq1SXerijvEUG62xI/edit)". _Feel free to reuse or fork this deck to help break down the inner magic of IPFS for others._ [Here's a recording](https://youtu.be/0IGzEYixJHk) of this deck being used in practice to explain how IPFS works (from the October 2019 Osaka IPFS Meetup).

  - Still have questions? [IPFS Simply Explained](https://www.youtube.com/watch?v=5Uj6uR3fp-U) does a great job visualizing how IPFS addresses some key use cases and needs to upgrade the internet.

- **IPFS Deep Dive Workshops:** These two videos - [How IPFS Deals with Files](https://www.youtube.com/watch?v=Z5zNPwMDYGg&list=PLuhRWgmPaHtSsHMhjeWpfOzr8tonPaePu&index=2&t=0s) and [The Lifecycle of Data on the Dweb](https://www.youtube.com/watch?v=fLUq0RkiTBA&list=PLuhRWgmPaHtSsHMhjeWpfOzr8tonPaePu&index=3&t=8s) - are great workshops on how core components of the IPFS network fit together. Feel free to watch these together, or just use as inspiration.

- **Context and Vision for IPFS:** In [Why IPFS?](https://www.youtube.com/watch?v=zE_WSLbqqvo) and [Building Web3](https://www.youtube.com/watch?v=pJOG5Ql7ZD0), Juan Benet talks about how IPFS fits into a longer-scale evolution of technology and our progress on building the new set of capabilities to power web3. The amazing video in "Why IPFS" that sets the stage for our place in the cosmos is "[Our Story in 1 Minute](https://www.youtube.com/watch?v=ZSt9tm3RoUU)" by melodysheep.

- **IPFS Intro with Interactive Demo** [@NukeManDan](http://github.com/nukemandan) gives a basic overview and provides and interactive demo with [PeerPad](https://peerpad.net/) for the audience. Here is a [video](https://www.youtube.com/watch?v=D3MjB45YZsM) to model after and the [slides](https://docs.google.com/presentation/d/1NyDePRHlP1Gqnf-5GvVAMnR4VFvbqVxAUH3lMsoHrB0/) used. To generate nice looking QR codes to replace in the slides for your own, check out https://qrcode-monkey.com/ . You are also encouraged to reach out to [@NukeManDan](http://github.com/nukemandan) for assistance or feedback on these materials.

### Community Calendar

We have a community [Google Calendar](https://calendar.google.com/calendar/embed?src=ipfs.io_eal36ugu5e75s207gfjcu0ae84@group.calendar.google.com&ctz=UTC), where you can watch for events and sync to. We will add relevant events concerning IPFS to it, both with geographical and interplanetary (online) locations. 

[![Screen Shot 2019-05-23 at 3 34 09 PM](https://user-images.githubusercontent.com/618519/58290901-3b86a600-7d70-11e9-98d0-03f25b58c7aa.png)](https://calendar.google.com/calendar/embed?src=ipfs.io_eal36ugu5e75s207gfjcu0ae84@group.calendar.google.com&ctz=UTC)

If you know of an event that has a set date and location and is _not_ listed on the calendar, please open an issue on this repository requesting that it be added to the calendar.

## Contribute

Feel free to join in! All welcome. Your best to start is probably either in [contributing.md](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md) or in [the issues](https://github.com/ipfs/community/issues).

This repository falls under the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).

**Want to hack on IPFS?**

[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)

## Ecosystem Projects

If your project/product uses IPFS, you're in the IPFS ecosystem! We'd love to see all projects in the IPFS ecosystem be discoverable and used by the broader community! 

### Showcase Your Project!

Follow the steps below to submit your projects to be featured in this [repo](https://github.com/ipfs/community/tree/master/projects):

- Create a project profile here in the ipfs/community repository using the [project submission template here](https://github.com/ipfs/community/blob/master/templates/project-submission-template.md). Name the file name after your project and fill in as much information as you can.  Use your project name as the file name so the community can find your project easily!

- Create a project discussion in the Discussion board on this repo, with the category as `Show and tell - Developers`  and title as `[Category] Project Name`(i.e: `[Application] Slate`), link the discussion in the How the community can engage section of your project submission. This is to create a place to interact with the community, share your updates and gain feedback on your projects! If you update your project Discussion regularly, those updates can be picked up in the IPFS newsletter, social sharing, get invites to speak at IPFS meetups or other events, and more!

- Once the project profile is ready, create a [PR](https://github.com/ipfs/community/pulls), prefix `[Project Submission]` in the title

- If everything looks good, the repo maintainers will merge the PR and voila, as simple as that your project is now featured here!

### Updates and Newsletter

We'd encourage all projects featured in this repo to share all of your thrilling updates with the community! Start a new comment with header `Project Name Update/Newsletter - Date` (i.e `## Slate Update - Feb, 2021`) in your project discussion to share the exciting news with the community!

## License

This repository is mainly for documents. All of these are licensed under the [CC-BY-SA 3.0](https://ipfs.io/ipfs/QmVreNvKsQmQZ83T86cWSjPu2vR3yZHGPm5jnxFuunEB9u) license © 2019 Protocol Labs Inc. Any code is under an [MIT license](LICENSE) © 2019 Protocol Labs Inc.