<div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">On Wed, Aug 14, 2013 at 6:53 PM, Paul W. Frields <span dir="ltr"><<a href="mailto:stickster@gmail.com" target="_blank">stickster@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class=""><div class="h5">On Thu, Aug 15, 2013 at 08:21:11AM +0800, Christopher Meng wrote:<br>
> 在 2013-8-13 PM8:41，"Matthew Miller" <<a href="mailto:mattdm@fedoraproject.org">mattdm@fedoraproject.org</a>>写道：<br>
> > It does when I'm this exhausted from Flock. :)<br>
><br>
> So I think this page should be more official like put it into docs.fp.o<br>
> instead of wiki page, cuz wiki page can be edited by any people, users are<br>
> confused if it's really helpful or just one by one ideas...<br>
<br>
</div></div>While I agree that the page should be useful and well curated on the<br>
wiki, adding another task to the already well-tasked docs team is not<br>
a good move. Documents like this are likely to change slightly very<br>
often, especially during development of new upgrade related features.<br>
That makes them poor candidates for official docs that (1) have a much<br>
higher barrier to entry for content, and (2) only get a lot of love at<br>
specific points in the release cycle.<br>
<br>
Keep this doc where it is but cleanup efforts are always greatly<br>
appreciated.<br>
<span class=""><font color="#888888"><br>
--<br>
Paul W. Frields <a href="http://paul.frields.org/" target="_blank">http://paul.frields.org/</a><br>
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717<br>
<a href="http://redhat.com/" target="_blank">http://redhat.com/</a> - - - - <a href="http://pfrields.fedorapeople.org/" target="_blank">http://pfrields.fedorapeople.org/</a><br>
The open source story continues to grow: <a href="http://opensource.com" target="_blank">http://opensource.com</a><br>
</font></span><div class=""><div class="h5"><a href="https://admin.fedoraproject.org/mailman/listinfo/docs" target="_blank"></a></div></div></blockquote></div><br><div><div><div><div>We *do* cover this in actively maintained
documentation, namely
<a href="http://docs.fedoraproject.org/en-US/Fedora/19/html/Installation_Guide/ch-upgrade-x86.html">http://docs.fedoraproject.org/en-US/Fedora/19/html/Installation_Guide/ch-upgrade-x86.html</a>
. 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.<br><br></div>I can see a problem with the approach, though, and some possible solutions.<br></div>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. <br></div>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.<br></div><div>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<br>4) ?<br><br></div><div>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
<a href="http://docs.fedoraproject.org">docs.fedoraproject.org</a> , and keep the feedback coming.<br></div><br></div><div class="gmail_extra">--Pete<br></div></div>