Docs on the wiki (was: Regarding Fedora badges for Beat Writing)

[Ben Cotton]

On May 22, 2015 9:51 PM, "Matthew Miller" <mattdm at 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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150522/8aab7384/attachment.html>