Update: January 10, 2022:
The first iteration of the guidelines for articles is now in the Help Center, and the new Article Creation tool for Collectives is live as of today.
Update: December 29, 2021:
I've updated this question to reflect what I believe is consensus among those who have discussed in the answers and comments. If I have misinterpreted, please feel free to call it out. Because of the need to deploy the Article Creation tool, I need to start to bring this comment period to a close. Does this mean that the guidelines are "locked" and can not be changed? Of course not. As with almost everything we do, these guidelines are iterative and the community owns them. My involvement here should only be considered as an attempt to spur things along - this does not imply that the company is claiming ownership over the guidelines. To be clear: these are just like any other guidelines here, and can be iterated upon, updated, and changed as needed.
Sometime during the week of January 10th, we'll transition these guidelines over to the help text pages, and deploy the Article tool.
I wish to thank everyone who contributed to this discussion for their time, for their skepticism, and for being able to see past that skepticism. And as always, please know how much we (the company, the staff, the whole darned world) appreciate all the work you put into building this site.
(Original post follows)
Before reading this post, may I ask that you please read Teresa’s post today (The Foundations of Collectives and its Future) very thoroughly?
With that out of the way (and I think it’s critical to understand that history to see how we get to this point), let’s talk through the goals for this post and the work already done.
As background, when we introduced Articles on Collectives, some community members self-organized to create a set of Guidelines. This is, to steal a phrase, A Good Thing. I want to encourage community ownership over these Guidelines and guidelines. In addition to that self-organization, I introduced a conversation about the types of articles that we had identified, to find out if there were use cases we had missed.
What has happened so far?
Here is a summary of what they have accomplished so far: First, community discussion (led largely by EJoshuaS-ReinstateMonica) led to three questions that were exposed. These three questions are things that we have debated a great deal internally, and I lay out after each what I think our feeling is, but I’m looking forward to hearing more from you about them.
As this all happened, our team has been building what we’re calling the “Article Proposal Flow” - it’s not far from being ready to go. This is exciting, because it allows collective members to draft their own articles, accept feedback on them, and submit them for inclusion in the collective.
The three questions that were exposed:
Your article is in another castle: should link-only articles be allowed?
Staff feeling: No. Link-only articles are not acceptable. Content must be resident on the collective. However, it does not necessarily need to be (but ideally is) content written exclusively for the collective. That is, repurposed articles would be allowed, but they must be resident on Stack Overflow, in the collective. It’s also important to recognize that anything posted to our site is licensed under the Creative Commons license as well. (Guideline 2.5 updated below).
Is it acceptable to have 'thanks' in an article?
Staff feeling: It depends on the context. If an article solicited opinions on something, and found them helpful, it might be reasonable to hear a “thanks” to the community for jumping in to the prior article. Outside of a situation where there was a substantive piece of work done, though, we would encourage article writers to not include “thanks”. (Guideline 2.11 updated, below).
Are articles allowed to be off-topic?
Staff feeling: Articles should be germane to the topics included within the collective, and should relate to one of the tags that is included within the collective, and within the greater, already established scope of SO. (Guideline 2.3 updated, below).
Next, we discussed the proposed types of articles that would be included: knowledge articles, and how-to guides.
Gaps
We have also identified some significant gaps in the proposed Guidelines, which we aim to close through this process as well. Outstanding questions for us include:
GAP 1 - What is the role of site moderators in collectives, and what should their accessibility level to articles be? What expectations exist of them, and are they appropriately resourced to fulfill those expectations? (Guideline 4.1)
GAP 2 - In case of a dispute between the author of an article and a client company, what is the correct escalation process to get to a positive outcome? I suspect that this will involve moderator teams communicating with Community Managers, but I think we should evaluate some potential possibilities. (Guideline 4.2)
GAP 3 - The role of the feedback button in articles: is it to give feedback on the topic of the article, the content of the article, or can it be used for anything related to collectives (broadly construed)? If constrained to the topic of the article or the content of the article, what is the appropriate path to give feedback about the collective to either Stack Overflow or the client company?
GAP 4 - Additional use cases: How to (and whether we should) allow for things like sharing best practices on a technical topic, comparing two or more technical implementations, and presenting the real-world use of a technology (i.e., case study/novel use case). (Guideline 4.3)
GAP 5 - Why articles? (And why not self-answered Q&A?)
We explored articles for Stack Overflow after hearing in research sessions that long-form content, paired with the system of trust on the site, was potentially a useful feature. They cover different ground than Q&A in two ways:
Knowledge articles cover topics too broad or open-ended for a single Q&A. They may compare the pros and cons of different kinds of implementations or approaches, and may be more subjective than is the norm in Q&A, provided opinion is backed by solid evidence.
How-to guides likely offer more than the answer to a single question, providing multiple steps (and potential pitfalls) on the path to accomplishing a technical goal. While it’s totally possible some overlap will occur, we see articles as being a home for content that would be too wide of a scope to cover usefully in Q&A format.
Next Steps
I’d also like to be transparent that we are approaching this set of Guidelines with three primary stakeholders: Stack Overflow (the company), the Community, and clients. We have done extensive research into the clients’ needs and will be exposing what we’ve learned from some of that as we talk about these proposed Guidelines.
I’m very interested in hearing some thoughts from this community - from you - on these proposals, but also in identifying holes in what is already identified.
A couple of thoughts on participation:
Proposed Guideline 3.0 has already been dealt with: we took announcements out of the scope of collectives at this point. So I think we can put that topic aside for now.
If you have feedback about any of the other proposed Guidelines, I invite you to leave an answer (probably one per person, with all of your suggestions for the Guidelines incorporated within) and tell us what you think. This includes suggestions for new Guidelines that we can discuss and consider adding to the finalized set of Guidelines.
Through community work, a set of proposed Guidelines was advanced (which I have grouped into families below):
—— Begin guidelines ——
We explored articles for Stack Overflow after hearing in research sessions that long-form content, paired with the system of trust on the site, was potentially a useful feature. Articles cover different ground than Q&A in two ways:
Knowledge articles cover topics too broad or open-ended for a single Q&A. They may compare the pros and cons of different kinds of implementations or approaches, and may be more subjective than is the norm in Q&A, provided opinion is backed by solid evidence.
How-to guides likely offer more than the answer to a single question, providing multiple steps (and potential pitfalls) on the path to accomplishing a technical goal. While it’s totally possible some overlap will occur, we see articles as being a home for content that would be too wide of a scope to cover usefully in Q&A format.
Guidelines to prevent spam:
1.0 - (References) Articles must back up their claims with facts and references.
Guidelines related to topics and content:
2.0 - (Fully discuss content) Articles should contain sufficient context for the problem that they are intending to address. They should focus on a practical problem that programmers actually face. Articles must fully address the problem they are intending to discuss. Readers should be able to get a clear understanding of how to solve their problem from reading the article.
(2.1 was merged into 2.0)
2.2 - (Reasonable length) Topics that would require extremely lengthy articles to address in full should ideally be split into multiple articles. If there is other context required, the articles should clearly indicate what context is needed.
2.3 - (On topic & within scope) Articles should be germane to the topics included within the collective, and should relate to one of the tags that is included within the collective, and within the greater, already established scope of Stack Overflow. Articles may be about any of the following, provided that they are clearly related to the topic of the collective:
- Algorithms
- Tools or software libraries used primarily by programmers
- Specific programming problems
Articles cannot be about any of the following:
- General computing
- Network or server administration
- Legal advice
- Opinion-based topics
- Hypothetical or speculative articles, rants, etc.
- Anything not directly related to programming
- Programming topics not directly related to the topic of the collective
(2.4 was merged into 2.3)
2.5 - (Links within articles) Link-only articles are not acceptable. If they contain links, they must have sufficient context, and content must be resident on the collective. However, it does not necessarily need to be (but ideally is) content written exclusively for the collective. That is, repurposed articles would be allowed, but they must be resident on Stack Overflow, in the collective. It’s also important to recognize that anything posted to our site is licensed under the Creative Commons license as well.
2.6 - (Titles) The title must summarize the content, without being misleading.
2.7 - (Language) Articles must be in the primary language of the target site that they accompany (currently English, since collectives "accompany" the main SO site; if there's ever a collective for another site, like the Russian SO site, it must be in the primary language of that site). Articles should use good grammar, spelling, and punctuation to the best of the writer's ability.
2.8 - (Code of Conduct) Articles must follow the Code of Conduct; abusive or insulting language will not be tolerated. All users must be treated with respect, as should anyone who is mentioned within an article.
2.9 - (Self-promotion) Articles may not engage in excessive or undisclosed self-promotion.
2.10 - (Content Duplication) Articles should not be exact duplicates of existing Q&As or articles.
2.11 - (Salutations, thanks, and closings) As with the rest of Stack Overflow, the use of the phrases “thank you” and similar salutations and closings/signatures are not considered best practice. However, there are times when this may be appropriate. For instance, if an article solicited opinions and the author found them helpful, it might be reasonable to hear a “thanks” to the community for jumping in to the prior article. Outside of a situation where there was a substantive piece of work done, though, article writers are encouraged to not include “thanks”.
Guidelines related to administration
4.1 - (Moderators) Stack Overflow’s moderators remain the community’s “exception” handlers, and the arbiters of these guidelines. They continue to be vested with the authority to moderate content within collectives, though they are encouraged to be sensitive to the needs of the collective’s sponsoring organization. In case of dispute, issues can (as always) be escalated to the community management team.
4.2 - (Recognized members) In addition to moderators, each collective has “recognized members” who are granted additional (limited) ability to provide input on articles that are in a draft phase.
4.3 - (Use cases) While Collectives are in a beta phase, community members are encouraged to remember that there may be some experimentation around potential additional use cases. Feedback is welcome in these cases, as we all get used to this new content type.
Guidelines that are no longer needed
3.0 - (Deprecated) We need to make a decision about product announcements, news, app store policies, etc. This Guideline was removed because the announcements feature was removed from Collectives.