I’ve started a project I hope can be helpful to the ReasonML community. The idea is to crowd source helpful information for newcomers, in a format that’s not formal (and not necessarily polished). Quantity over quality here, I’m interested in gathering as much information as possible rather than creating perfect and polished guides and answers (there are other arenas/places where that type of thing can live).
It consists of a GitHub repository (https://github.com/zth/reasonml-q-a) where the idea is this:
- Newcomers (or any members of the community really) post their questions as regular issues.
- Members of the community help triage, label and answer the issues. Discussions can ensue, just like in regular issues.
- Everything labelled as publishable with automagically end up published on https://reasonml-q-a.netlify.com/. This hopefully means it’ll end up in search engines, and people will find their way there. This is made possible through the sheer wizardry of @sgrove and onegraph.com, which has allowed me to set this whole thing (GitHub repo -> actual blog) up with like 3 clicks :mind-blown:.
What I want to achieve is the following:
- Give people a natural place to post questions and get answers that other people can find easily. Discord is really really great for getting answers, but it’s not searchable or findable for an outsider. This forum is great for getting answers, but it IMO caters to a more thought through type of question than what I’m looking for here.
- Establish the behavior of contributing both questions and answers to the community. Somewhere natural place to put your thoughts/questions/frustrations that’s visible to the entire community.
- Create and curate a large body of questions and answers that can help people when they get stuck.
The more we cover the better, even if the question is a one-liner and the answer is just a link. It’s about creating a discoverable foundation of information that’s useful in itself, but also usable for advancing the community in other ways.
Ideas for the future:
- Build simple bots for both Discord and Twitter that’ll allow us to easily transfer questions (and maybe even entire conversations with answers etc) from that medium to this issue tracker.
- Curate, categorize and summarize the information as we get it. Think “Here’s the top issues when getting started”, or “This is what people typically don’t get instantly with ReasonReact”.
- Use this as a base to improve actual documentation, write polished guides and what not. This can hopefully help with all of that.
breathes There, what are your thoughts on this? Anyone interested in helping out answering questions etc? How can we make this as approachable and welcoming as possible?
Thank you for reading!