On May 22, 2015 9:51 PM, "Matthew Miller" <mattdm(a)fedoraproject.org>
wrote:
I think our basic goal is moving _user docs_ away from the wiki
entirely, and keeping it as a contributor workspace only -- good for
drafts, for test matrices, etc -- but anything that users would hit
should be on future new "short, more-polished userdocs site". (Anyone
disagree?)
I have no shortage of opinions on the matter, but the TL;DR is that I
vehemently agree with this. I'm generally opposed to wikis as documentation
for a variety of reasons, but they do have certain appealing traits.
If we use them for anything, it should be a drafting ground for new
content. Of course, that means doing most of the markup after the fact,
which has its own disadvantages, but it lowers the bar for new contributors
to come in.