On Wed, Aug 14, 2013 at 6:53 PM, Paul W. Frields
<stickster(a)gmail.com>wrote:
> On Thu, Aug 15, 2013 at 08:21:11AM +0800, Christopher Meng wrote:
> > 在 2013-8-13 PM8:41,"Matthew Miller"
<mattdm(a)fedoraproject.xn--org>:-0s6m5392c
> > > It does when I'm this exhausted from Flock. :)
> >
> > So I think this page should be more official like put it into docs.fp.o
> > instead of wiki page, cuz wiki page can be edited by any people, users
> are
> > confused if it's really helpful or just one by one ideas...
>
> While I agree that the page should be useful and well curated on the
> wiki, adding another task to the already well-tasked docs team is not
> a good move. Documents like this are likely to change slightly very
> often, especially during development of new upgrade related features.
> That makes them poor candidates for official docs that (1) have a much
> higher barrier to entry for content, and (2) only get a lot of love at
> specific points in the release cycle.
>
> Keep this doc where it is but cleanup efforts are always greatly
> appreciated.
>
> --
> Paul W. Frields
http://paul.frields.org/
> gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
>
http://redhat.com/ - - - -
http://pfrields.fedorapeople.org/
> The open source story continues to grow:
http://opensource.com
> <
https://admin.fedoraproject.org/mailman/listinfo/docs>
>
We *do* cover this in actively maintained documentation, namely
http://docs.fedoraproject.org/en-US/Fedora/19/html/Installation_Guide/ch-....
While I'm glad that someone has been taking time to keep the
information
on the wiki up to date, our practice has been that once the information is
in a Guide, we focus our attention there rather than maintaining scratch
wiki pages.
I can see a problem with the approach, though, and some possible solutions.
1) If the wiki page is not the best source for the topic, redirect to the
Guide that is as required. I'd probably add a note for whoever has been
maintaining the page to communicate with the guide owner by mail or bz.
2) cron a script to convert the Guide content to wiki text and dump it in
the wiki. Error prone, but it would keep the wiki info going.
3) Break the upgrading copy out of the IG an into an independent guide.
This is really the only way that adding pre-release and rawhide copy to an
official would make sens
4) ?
In any case, if there's something to be done, it should deduplicate work,
not require redundant effort. Granted, editing a wiki page is much easier
for a casual contributor, but doing that is not likely to bring the
required changes to the attention of someone maintaining the official
Guides. Please, refer your friends and users to the official documentation
at
docs.fedoraproject.org , and keep the feedback coming.
Oh! I guess like a lot of people, I didn't realize that had
transitioned over to a guide. The wiki typically should involve
little process, fast change, and "ask forgiveness rather than
permission" wherever possible. The front page and a few other
governance related pages should be treated with kid gloves, but this
is an example of a page that could just be retired and point to the
guide.
Nothing's lost by removing most of the page content and including a
link to the maintained guide. I'd recommend that.
--
Paul W. Frields