@@ -15,44 +15,39 @@ community = """
1515# Community
1616
1717 * [Community Packages](http://package.elm-lang.org/)
18- * [Mailing list][list]
1918 * [Reddit][reddit]
2019 * [Slack][slack]
2120 * [Twitter][twitter]
2221 * [Real Life][real-life]
22+ * [Mailing list][list]
2323 * [Contributing](#contribute)
2424
2525<br>
2626
27- ## Mailing list
2827
29- [list]: https://groups.google.com/forum/?fromgroups#!forum/elm-discuss "mailing list"
28+ ## Reddit
3029
31- The [elm-discuss][list] mailing list is a great place for
32- friendly discussion! Common activities include helping folks use Elm,
33- discussing API design, reviewing blog posts and libraries, and finding projects
34- to collaborate on.
30+ [reddit]: http://www.reddit.com/r/elm
3531
36- This list is all about learning and improvement, so even if you know a lot
37- about Elm or functional programming, be humble and open to learning new things
38- from anyone! Try to read some old emails to get a feel for the culture and who
39- everyone is.
32+ [/r/elm][reddit] is a great place for friendly discussion! Common activities
33+ include helping beginners, discussing blog posts, announcing and reviewing
34+ packages, etc.
4035
36+ The online Elm community is all about learning and improvement, so even if you
37+ think you know a lot, be humble and open to learning new things from anyone!
4138
42- ## Reddit
39+ Also, be kind! Friendly disagreement is healthy, but [displacement][] of
40+ personal anger onto friendly strangers is not.
4341
44- [reddit]: http://www.reddit.com/r/elm
45-
46- Check out [/r/elm][reddit] to find out about new libraries and read blog posts.
47- Or even better, use it to announce libraries and post your own blog posts!
42+ [displacement]: https://en.wikipedia.org/wiki/Displacement_(psychology)
4843
4944
5045## Slack
5146
5247[slack]: http://elmlang.herokuapp.com/
5348
54- Got a quick question, but don't feel comfortable asking on the mailing list ?
55- Chatting on [Slack][slack] is a great way to quickly learn from a real person.
49+ Got a quick question, but don't feel comfortable asking on Reddit ?
50+ Chatting on [Slack][slack] is a great way to quickly learn from a real person!
5651
5752As for culture, prefer to ask rather than tell. You may be talking to someone
5853with no programming background or a PhD in programming languages, so to answer
@@ -85,15 +80,30 @@ the Elm user group in SF. A lot of existing meetups are structured based on
8580[hack-night]: http://tech.noredink.com/post/142283641812/designing-meetups-to-build-better-communities
8681
8782
83+ ## Mailing list
84+
85+ [list]: https://groups.google.com/forum/?fromgroups#!forum/elm-discuss "elm-discuss"
86+
87+ The [elm-discuss][list] mailing list is the original online forum for Elm. We
88+ used to do all discussion there, from beginner questions to language design
89+ discussions. These days it is in between [/r/elm](https://www.reddit.com/r/elm/)
90+ and [elm-dev](https://groups.google.com/d/msg/elm-dev/oZ3xW_nMPNo/0y8j-N8HCQAJ).
91+ There are some people (and their expertise) only available through email!
92+
93+
8894## Contribute
8995
90- **Every great contributor starts gradually.** At first this means simply using Elm,
91- maybe blogging about things they find interesting. After that, some folks
92- will find things they want to make easier and build packages, like [elm-css][],
93- that directly address their personal needs. This can be a great learning experience
94- if you get folks in the community to review your API. It is also a great way to
95- build relationships and trust with people. From there, people may work on projects
96- like [these](https://github.com/elm-lang/projects) that are more core. This is
96+ I recommend watching [this talk](https://youtu.be/DSjbTC-hvqQ), which has a
97+ big focus on growing Elm and collaborating.
98+
99+ Here are some of the ideas in words. **Every great contributor starts
100+ gradually.** At first this means simply using Elm, maybe blogging about things
101+ they find interesting. After that, some folks will find things they want to
102+ make easier and build packages, like [elm-css][], that directly address their
103+ personal needs. This can be a great learning experience if you get folks in
104+ the community to review your API. It is also a great way to build relationships
105+ and trust with people. From there, people may work on projects like
106+ [these](https://github.com/elm-lang/projects) that are more core. This is
97107how [elm-format][] and [elm-test][] were created.
98108
99109[elm-css]: https://github.com/rtfeldman/elm-css
0 commit comments