I am for a wiki. My schedule is erratic. Sometimes I have three days in which I can do
writing or editing, and at other times, once a month.
I have edited one or more wiki sections. It was easy. My changes were accepted. By the
way, I only provided information in English for the English wiki, and I guess that is a
potential problem.
However, when wiki sections are unchanged, the translations to these sections are also
unchanged. Updating or revisions to a new Fedora release would be more painless for we
contributors than letting the team down because our personal time commitments got in the
way of writing, editing or translation .
Regards
Leslie
Mr. Leslie Satenstein
Montréal Québec, Canada
From: Pete Travis <me(a)petetravis.com>
To: For participants of the Documentation Project <docs(a)lists.fedoraproject.org>
Sent: Friday, August 12, 2016 12:39 PM
Subject: Re: Should we stop publishing the current guides now?
On Aug 12, 2016 10:12 AM, "Dylan Combs" <dylan.combs(a)gmail.com> wrote:
I don't mean to just beat a perhaps-dead horse, but I really can't get past the
opposition (which I don't understand) to a wiki-like environment for our documentation
which would facilitate this very thing.
I know there are concerns about "gardening" such a wiki, but seriously, if we
can put in place a system similar to
ask.fedoraproject.org where users are provided badges
and karma for their work, I think that's the best we can do to promote user
involvement in conjunction with an easy click-and-you're-in system for people to
simply edit the content they're reading at that very moment, in real time.
I know I would contribute heavily to such an environment. I contribute heavily to
ask.fedoraproject.org in no small part because I can quantify my involvement, and this
helps in a lot of ways people might not expect; I have even used my contributions to
ask.fedoraproject.org as validation of my skills for my employer. reasons used it in job
applications and resumes to demonstrate the quality of my writing and my ability to solve
a variety of problems.
If we could just simplify the documentation process by providing an easily-edited
repository with a service that quantifies user involvement, that, in my estimation, is the
best model for maintaining active, accurate documentation for our user base. It
dramatically simplifies the involvement process (getting into6
ask.fedoraproject.org is so
easy, new accounts pop up all the time, and contributions even from low-level accounts
have been very valuable), it makes the whole thing accessible, and for long-term
contributors, it provides a means by which to quantify and qualify their involvement in
the Fedora community, and this is a feature that can be used by anyone for whatever
purpose they may have.
Our current system is extremely opaque, and the documentation is relatively static. We
have to change that, in my opinion, and a simple Wiki with a user base consisting of
moderators and contributors, managed by a karma and badge system, is the way to go.
I only propose this, yet again, because I just don't see the rationale in its
opposition. It seems to have elicited a few relatively enthusiastic notes of support from
this distribution group along with a few somewhat vague concerns which I think have been
addressed.
Can we just chase this one down and prove that it is either unsuitable or valid as a
solution for our issue? We gotta move on this!
-Dylan
We did chase this down and determine that a wiki did not meet our needs, for a variety of
reasons