Note: This is the first in a series of questions about Articles in Collectives.
About Articles on Collectives
When we introduced Collectives on Stack Overflow, we also introduced a new content type: Articles. At the time, we made a calculated decision to not drop a set of guidelines for articles on the community at the same time, because our preference was the guidelines that we set would be influenced by real life - we intended to watch how the community treated articles, and watch the response, and then come forward with a draft of some guidelines that matched that reality.
Spoiler alert: As it turned out, this was probably not the best way to introduce the feature. We had the best of intentions, but it didn't work out. Lesson learned, note taken.
What now?
I'm here to take another run at getting to some guidelines. Over the next few days and weeks, I hope that we can have a conversation about articles and what guidelines we can put around them. We've done some staff work on this internally (including talking to our clients to hear their motivations and needs, and now we're also talking to you here to be sure that we're building something that's of value to the community), and I'll be referring to all of those conversations to ensure that we're taking a balanced approach toward this. This is your chance to weigh in and help craft the guidelines. In addition to me, you'll probably see comments from some of the Community staff, and from some of the researchers who have been working on this feature, and no doubt from the product folks that are deeply invested in making this a useful feature.
I envision this as a bit of a guided conversation: I'll ask some questions, look for answers and comments, and attempt to summarize it as we go. I'll propose some language, we can iterate on it, and we can land on the final language.
Potential article types
For context setting, articles are currently only able to be submitted by certain users. However, an upcoming release will include a tool that allows community members to draft and submit articles for inclusion in a collective. We’re currently on track to release that this quarter (please read this with the usual caveats…. unforeseen complications, etc).
So far, we've identified two types of potential articles that are a fit for the Collectives product (and several that are not, one of which I'll mention explicitly below):
The first type that we think is a fit is a how-to guide, which provides step-by-step guidance for using a technology or set of technologies to complete a task or achieve a desired outcome. We're thinking of these like recipes, larger and more holistic than a single Q and A (and could be drawn from several Answers).
The second is a knowledge article, which explores a technical topic by sharing the process, data, and reasoning that led to a particular approach or decision. This is content that is more evergreen and may be more theoretical than a how-to guide. They may be used for things like comparing technical solutions or implementations and best practices.
A formulation that seems to work to know the difference here is that where How-to Guides are "This is how I did this thing", Knowledge Articles are "This is why I did the thing this way."
A third type, which I am taking off the table here, is announcements. We are rethinking how we would approach a feature like announcements at some time in the future.
For the purposes of this discussion, I'm going to ask that we keep responses narrowly constrained to the questions being posed (and don't worry, you'll have a chance to pose your own questions and I have no doubt that opinions will be aired, but I'd like them to be germane to the topic so that we don't all have to do a collective context switch to read and follow them).
Questions to you
So our first set of questions to you is:
- What have we missed?
- Do you have feedback on the purpose of the first two Article types mentioned above?
- What use cases could you see these first two Article types being useful in?
- What use cases do you feel they could be detrimental in?