Page MenuHomePhabricator

Systematic use of FAQs in complex or controversial conversations
Closed, ResolvedPublic

Description

Everybody agrees with the theory that frequently asked questions (and frequent misconceptions) should be documented in FAQ pages. This way, whenever someone raises the same question or concern again, the simplest and best answer is to point to the answer in the FAQ.

However, in the middle of discussions (especially when they are complex or controversial) it is easy to forget this theory and just reply directly in the discussion. The Technical-Collaboration-Guidance could standardize a suggestion for projects to create a FAQ page upfront, or at least as soon as frequent questions start to raise.

It happens too often that complex or controversial topics are discussed at length in various places, and sometimes again (and again) months or years later. In these discussions, well informed contributors sometimes take the time to provide answers. And just too often those answers end up being buried in discussions, not reaching future readers, or new contributors basically rewriting those answers in new discussions.

Event Timeline

What happen if the answer written is the FAQ is not admitted by someone? (And an edit war ensues?)

There are many options to deal with edit wars in the Wikimedia world. Move the contested question to the discussion page, revert and ask any issues to be discussed in the talk page, protect the page temporarrily... In case of doubt, the MediaWiki.org community should define theirs (because these FAQ pages are expected to be there).

sgrabarczuk claimed this task.