You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Welcome to the Filecoin community repository! You can treat this repo as your go-to for all meta, non-code discussions in the [*Discussions*](https://github.com/filecoin-project/community/discussions), documents used by multiple repositories (such as the Code of Conduct), and how to interact with the Filecoin project and other community members.
29
+
Welcome to the Filecoin community repository! You can treat this repo as your go-to for all meta, non-code discussions in the [*Discussions Forum*](https://github.com/filecoin-project/community/discussions), documents used by multiple repositories (such as the Code of Conduct), and how to interact with the Filecoin project and other community members.
30
+
31
+
To get the latest network notifications, subscribe to [status.filecoin.io](https://status.filecoin.io).
32
+
33
+
If you are interested in discussing code or protocol design, feel free to come talk to us on our [forums](#forums), [chat channels](#chat), or in issues on our other [Filecoin project repos](https://github.com/filecoin-project).
34
+
35
+
## Join the Community
28
36
29
-
If you are interested in discussing code or protocol design, feel free to come talk to us on our [discussion forums](#community-forum), [chat channels](#chat), or in issues on our other [Filecoin project repos](https://github.com/filecoin-project).
37
+
**> Note: Before posting to different communications channels, make sure to read the [Code of Conduct](https://github.com/filecoin-project/community/blob/master/CODE_OF_CONDUCT.md).**
30
38
31
-
## Discuss
39
+
The vast majority of the Filecoin Project conversations, including implementation, community support, ecosystem news, etc. take place on:
32
40
33
-
The vast majority of the Filecoin Project conversations are held on:
41
+
-[Forums](#forums) (mainly on Github Discussions)
42
+
- GitHub Issues (see [Implementation related repo](#impelmentation-related-repo) section below)
43
+
- Chat (mainly on Slack) (see [Chat](#chat) section below)
- Chat (on Matrix/Slack/IRC) (see [Chat](#chat) section below)
45
+
The Filecoin Project is an open sourced project with a very supportive and welcoming community, where many community members are responsive in various of forums and slack channels. We also have [Filecoin community ambassadors](https://github.com/filecoin-project/community/discussions/116#discussioncomment-617066) here to support you, tag their GitHub handlers in GitHub discussions or @fil-community-ambassadors in all slack channels if you have any questions!
39
46
40
-
We tend to be pretty responsive during normal business hours, which vary according to our timezones (we have a fully distributed team).
47
+
Implementation dev teams tend to check their corresponding GitHub repo issues and discussions regularly and try to respond within 5 business days.
41
48
42
49
We also push updates to the community via:
43
50
51
+
- Forum - [`Network and implementations updates`](https://github.com/filecoin-project/community/discussions/categories/network-and-implementations-updates) updates and [`news and events`](https://github.com/filecoin-project/community/discussions/categories/news-and-events)
49
59
50
-
Before posting to different communications channels, make sure to read the [Code of Conduct](https://github.com/filecoin-project/community/blob/master/CODE_OF_CONDUCT.md).
When in doubt or curiosity, please post in Filecoin community forum](https://github.com/filecoin-project/community/discussions)!
57
66
58
67
We love to hear what the community has to say, whether it is to:
59
68
60
69
- Ask a question
61
-
-Propose a new feature
70
+
-Gather community feedback on a new feature proposal before opening an FIP
62
71
- Share a new project you're working on
63
72
- Find collaborators for your own community project
64
73
- And whatever else! Honestly!
65
74
66
75
The discussion forum uses the same Code of Conduct as our other community channels. Please make sure to read this before posting.
67
76
77
+
> Note: A Chinese-language community forum is also available at https://github.com/filecoin-project/community-china/discussions. It is managed by [CoinSummer](https://github.com/CoinSummer).
78
+
79
+
#### lotus Discussion Forum
80
+
81
+
[lotus discussion](https://github.com/filecoin-project/lotus/discussions) is an all-in-one place where you can track [lotus releases and announcements](https://github.com/filecoin-project/lotus/discussions/categories/announcement), find [tutorials](https://github.com/filecoin-project/lotus/discussions/categories/tutorials) ask questions about running[ a lotus node](https://github.com/filecoin-project/lotus/discussions/categories/syncing), [lotus miner ](https://github.com/filecoin-project/lotus/discussions/categories/miner-q-a)or lotus client, get help with troubleshooting, [share your lotus setup or thoughts](https://github.com/filecoin-project/lotus/discussions/categories/show-and-tell), chat with your fellow developers with [how to build ](https://github.com/filecoin-project/lotus/discussions/categories/developer-q-a)applications using lotus JsonRPC API and so on.
82
+
83
+
84
+
#### Filecoin Proving Subsystem Discussion
85
+
86
+
The Filecoin Proving Subsystem (or FPS) provides the storage proofs required by the Filecoin protocol. If you have any question regard to the current proof, feedbacks for proof performance on different machines, ideas to improve proof or implementing new proof, join the [forum here](https://github.com/filecoin-project/rust-fil-proofs/discussions)!
87
+
88
+
### Implementation Related Repo
89
+
68
90
### Chat
69
91
70
-
You can join the conversation on chat via Matrix, IRC, and Slack.
92
+
Vast majority of community live chat is happening in [Filecoin Project Slack](https://filecoin.io/slack). Tag @fil-community-ambassadors if you have any questions!
71
93
72
-
Our primary chat channels are bridged (automatically copied) across Matrix, IRC, and Slack:
94
+
Fun channels to join once you are in the workspace:
73
95
74
-
-**Matrix:** The [Filecoin community](https://app.element.io/#/group/+filecoin:matrix.org) on Element (our preferred Matrix client)
75
-
-**Filecoin Project Slack:** Create an account or login with your existing account at [https://filecoin.io/slack](https://filecoin.io/slack)
-`#fil-announcements`: This channel is for official Filecoin announcements only (including network, implementations, and ecosystem announcements). Join to get most up-to-date news. Please do not post questions or other messages here; they will be deleted!
97
+
-`_fil-lobby`: for general Filecoin-related sharing
98
+
-`fil-help`: ask questions here if you can't find another specific channel for your question
99
+
-`fil-lotus`: for lotus related discussion
100
+
-`fil-fips`: for [Filecoin Improvement Proposals](https://github.com/filecoin-project/FIPs) related discussion
101
+
-`fil-plus`: for Filecoin Plus([notary-governance](https://github.com/filecoin-project/notary-governance)) related discussion
102
+
-`fil-net-calibration-discuss`/`fil-net-nerpa-discuss`: for testnet disucssions
103
+
-`fil-ecosystem-dev`: for updates and discussion about building in the Filecoin ecosystem
104
+
-`fil-deal-market`: promote your miner as a storage provider or find your provider as a client here
105
+
-`hackathons-help`: join this channel if you are participating any Filecoin hackathons and have questions
106
+
107
+
Primary Slack channels are bridged (automatically mirrored and read-only) to [Matrix](https://app.element.io/#/group/+filecoin:matrix.org).
77
108
78
-
Note that you can generally think of the above options as interchangeable. Note, however, that some channels may not be bridged across chat spaces.
79
109
80
110
### GitHub issues
81
111
82
112
If you find something puzzling or encounter a straight-up bug in any of our repositories, please file a well-scoped issue. The issue lists for our most active repositories are below:
If a repo has a Contributing Guide, please read it before filing an issue!
@@ -95,9 +125,16 @@ Almost anything you find that is a bug in the codebase should be filed as an iss
95
125
96
126
Please refer to [SECURITY.md](./SECURITY.md) document found in this repo on how to best report findings and participate on the bug bounty program.
97
127
128
+
## Useful links
129
+
130
+
If you are new to the Filecoin Project, below are some helpful links for you to learn more about it:
131
+
- Official website: [https://filecoin.io](https://filecoin.io)
132
+
-[Filecoin Specification](https://spec.filecoin.io): contains documents, code, models, and diagrams that constitute the specification of the Filecoin Protocol.
133
+
-[Filecoin Docs](https://docs.filecoin.io): offers all the necessary resources to learn about Filecoin, the software and the tools to contribute to the network, either as a user looking for storage, or as a miner providing it
134
+
98
135
## Ecosystem Projects
99
136
100
-
If your product uses Filecoin, you're in the Filecoin ecosystem! We'd love to see all awesome projects that are built on top of the Filecoin ecosystem to be known and get used by the Filecoin community!
137
+
If your project uses Filecoin, you're in the Filecoin ecosystem! We'd love to see all awesome projects that are built on top of the Filecoin ecosystem to be known and get used by the Filecoin community!
101
138
102
139
### Showcase Your Project!
103
140
@@ -112,6 +149,11 @@ Following the steps below to submit your projects to be featured in this this [r
112
149
113
150
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!
114
151
152
+
### Filecoin Shipyard
153
+
154
+
[Filecoin Shipyard](https://github.com/filecoin-shipyard) is a home we created for projects built by the Filecoin community. We encourage you to take a look around to explore some early projects incubated by the Filecoin community! If you're building something new on top of Filecoin, feel free to request to to add your project to the Shipyard!
155
+
156
+
115
157
## Events
116
158
117
159
Add our [Google Calendar](https://calendar.google.com/calendar/b/6?cid=ZmlsZWNvaW4ub3JnX2o3bW1ldjI0ZzgwcmVsbzU2cHFtMWVsMWUwQGdyb3VwLmNhbGVuZGFyLmdvb2dsZS5jb20) or follow issues in this repo to keep track of events (meetups, hackathons, etc.) hosted by the Filecoin Project and/or Protocol Labs.
@@ -149,16 +191,12 @@ We use a common [Code of Conduct](https://github.com/filecoin-project/community/
149
191
150
192
Each repo should have its own contributing guide, called `CONTRIBUTING.md`. Here is an example [Contributing Guide for `venus`](https://github.com/filecoin-project/venus/blob/master/CONTRIBUTING.md).
151
193
152
-
### Filecoin Shipyard
153
-
154
-
[Filecoin Shipyard](https://github.com/filecoin-shipyard) is a home we created for projects built by the Filecoin community. We encourage you to take a look around to explore some early projects incubated by the Filecoin community! If you're building something new on top of Filecoin, feel free to request to to add your project to the Shipyard!
155
-
156
194
## Maintainers
157
195
158
-
Maintainers are responsible for maintaining the content of this repo, reviewing the issues and pull requests and moderate the [discussion](https://github.com/filecoin-project/community/discussions).
196
+
Maintainers are responsible for maintaining the content of this repo, create an issue and tag one of the maintainers if you have any questions.
@@ -167,8 +205,3 @@ The Filecoin Project is dual-licensed under Apache 2.0 and MIT terms:
167
205
168
206
- Apache License, Version 2.0, ([LICENSE-APACHE](https://github.com/filecoin-project/community/blob/master/LICENSE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0))
169
207
- MIT license ([LICENSE-MIT](https://github.com/filecoin-project/community/blob/master/LICENSE-MIT) or [http://opensource.org/licenses/MIT](http://opensource.org/licenses/MIT))
0 commit comments