What categories should we have? or should we not have?

[brian]

This is a really interesting way to think about it. Now’s the time to experiment, so I’ll get these set up.

How about:

• Learn, Coordinate
• News -> Inform
• Site Feedback -> Report a problem / ask a question? I kinda want to call it “Meta” but that’s not an intent.

[evancz]

I’d say coordinate covers the feedback stuff. Your specific intent is to coordinate with other folks in the community about certain changes. You have specific work you are willing to do and you are soliciting feedback on that work.

Maybe this points to a better name for Coordinate. Perhaps Request Feedback? Or Coordinate / Request Feedback? Basically, I want people to say “I have this idea. What do you think of it?” and I think a meta tag instead promotes “I think this is bad.”

[brian]

I think I kinda see where you’re going with this, but I’m not super clear yet. Could you clarify something?

I feel like “I want to inform someone about Elm” is different than “I want to inform someone about this forum.” So Murphy’s package announcement has a different character than the wiki post I made about formatting code here. They’re both for informing, but I wouldn’t expect to see them together. Do you think those should be categorized differently?

Coordinate / Request Feedback

Another shade of this is “get help”. But that again depends on “help with Elm or help with this software”?

Also, would you say it’s fair to say that this categorization system is more about the people’s needs than the forum software’s needs?

[evancz]

I don’t think “I want to inform someone about this forum.” is a very productive goal. I think unsolicited informing-people-of-your-opinions does not work well, especially online. I’d always try to turn that into a question where there’s a chance I’ll learn something new. So instead of:

Currying is a bad idea. No one does it. It is hurting your growth.

It could ideally become:

I noticed that Elm does not use C-style function calls. What are the tradeoffs of that choice?

So this would be Learn by default or Request Feedback if they have a concrete idea they want to test with folks.

I was thinking of Help in the context of my idea where responses would be categorized as well. A Help would be a valid reply to a Learn post. I think I was going for announce with the Inform category: “Check out this thing I made!” I guess folks may take it as “Please allow me to inform you about … how stupid you are!” So maybe Announce is a better name for this category. I think Share captures the idea of “I’m so excited to tell you about what I made!” but it may be a bit to vague and encourage “I’d like to share … how stupid you are!”

I think Learn covers “get help”. If I have some code I am confused about, I want to learn something such that I’m not confused anymore.

So yeah, I’m thinking of the categories as “What is the goal of OP?”

Does that clarify things more?

[brian]

Yeah, thanks!

So is the thesis here…

if we create good categories intentionally, people will engage with each other in healthy ways

I dig it. API design for humans.

I’ll set up those categories in the morning.

[evancz]

Yes, that is definitely the thesis! Certain kinds of interactions are aligned with the goals of the forum, and the forum itself can help you be oriented towards those goal as well.

Based on this elaboration, I propose these categories:

• Learn
• Request Feedback
• Show and Tell

The Show and Tell category takes the place of Announce because I don’t personally feel comfortable announcing things like its all official and final. I’d personally be way more inclined to do a Show and Tell of a package I am working on than an Announce of that package. I’d love to have 0.19 categorized as Show and Tell actually

[brian]

Got excited about this so I’m doing it now.

Descriptions could probably be better. Evan, you have the ability to edit these. If you decide to do so and edit them substantially, would you mind just changing authorship to your username?

The Show and Tell Category

The Learn Category

The Request Feedback Category

I also removed the ability to post in “Uncategorized”, which is apparently a topic in it’s own right but gets special treatment.

Edit: forgot to add, I also gave these three of the primary logo colors. We have the dark blue left. It’s easier to see on https://discourse.elm-lang.org/categories

[evancz]

This is very exciting! Thanks for setting those up! (And setting everything up!)

I edited some to show examples. They are not perfect, but I wanted to model expected behavior more explicitly.

[brian]

You bet, and thanks for clarifying the category topics. There’s a nice second benefit to these categories as set up: you can think of them as a spectrum or a cycle.

So let’s pretend elm-benchmark doesn’t exist. I start off in Learn: “how are people doing performance testing?”. Cool, I learn some stuff, like harnesses around benchmark.js.

Then, I’m like “we should have a benchmarking library… but I’m not sure what it should look like.” Those ideas go in Request Feedback, and the community collaborates.

Then, finally, I write something (handwaving over the native code in the actual package for the moment.) Once it’s done, I show back up in Show and Tell with the announcement.

Afterwards, I need to add more features. Back to Learn, then Request Feedback, and maybe Show and Tell when/if they get added.

My conclusion: if people use these categories in this way, it sets up virtuous cycles where nice things get made collaboratively. Does this seem like a reasonable way to moderate this forum?

[roovo]

Love what’s been suggested so far One random thought is that to me Show and Tell is a one-way and directive sounding term and Show and Share feels more inviting and inclusive - would this make a better category name?

[evancz]

I think Request Feedback fits that better.

It can be very frustrating when you share something with folks and all the reactions are “That’s cool, but when are you going to add X?” Rather focusing on the thing that exists and taking a moment to appreciate a bunch of work, people who have not thought about the project deeply are just telling you about all the work you didn’t release yet, as if you asked them for advice or as if you don’t know already. So I personally think it’s good to make a distinction between “Here is a thing” and “Can you give me advice on X?”

I have a personal theory that “unsolicited advice” is not such a valuable category of interaction. I think it can work coming from someone you really trust in real life, but I haven’t seen it work well online in general, possibly because the signal-to-noise ratio can be so bad that sifting through is not the fastest path to the insights.

[avh4]

It seems like we’ve acted on the current decision of Learn / Request Feedback / Show and Tell… I think the welcome post (link) ought to be updated to describe the categories and their purposes.

In particular, I think Learn is the least clear to understand what its purpose is just from reading its name.

[evancz]

Knowing that folks tend to not read anything, I think the existing welcome post is way too long. Here’s a draft of a next version:

---

Welcome to the Elm discourse!

The goal of this forum is to encourage friendships, mentorships, and collaborations in the Elm community. Beginner questions are welcome. We love to help out!

There are three categories of posts on here:

• Learn - details
• Request Feedback - details
• Show and Tell - details

We hope this will guide folks towards goal-oriented discussions, where we take into account what the poster want to get out of the conversation, not just what we want to say. So before posting, ask yourself:

• Is my post as concise as possible?
• Is it helpful?
• Is it respectful of other people’s feelings and time?
• Does it link to evidence to support claims about other projects or languages?

High-quality contributions often get edited down quite a bit!

---

For more resources check out:

• The Code is the Easy Part talk on how collaboration works in the Elm community.
• The Code of Conduct about how to be constructive.
• The Forum Rules about the limits of this forum.

[brian]

You know how we have little sheets here that pop up, “welcome to Discourse” or “similar topics to your title…”? I’m curious if we could add those guidelines as sheets that would automatically pop up. If so, what would the criteria be?

Also, a meta note: this thread is getting a little long and away from @ento’s original question. We should consider forking it.

[ento]

I moved this to the Learn category, as my intention was that of inquiry and I didn’t have the means to execute on the feedbacks I received.

[brian]

Sorry about that! I needed to recategorize all the existing posts when setting up the new categories, so I guessed a bunch. Guess I got this one wrong!

[ento]

No worries! I also guessed when I recategorized and indirectly confirmed my
understanding by commenting with my reasoning.

[avh4]

Can we make Learn appear first in the dropdown list of categories when creating a topic? (I feel like that will be the topic we want to encourage for most new posters that aren’t familiar with the forum yet or aren’t completely sure what the categories are for.)

[brian]

good idea! I’ve made the change.

(for future reference: had to check the “categories are orderable” and “that’s true for creation too” boxes, then set an index in each category’s settings.)

[brian]