So, about a month ago we discussed the idea of replacing the documentation FAQ with one based in the wiki. Nothing was done, but the general consensus seemed to be to wait and see if the wiki approach worked out better.
Since that time, the Wiki FAQ has been updated by 7 people other than myself. We've removed most of the cruft, and taken the FAQ from an unhelpful mess to something a user actually should read. Meanwhile, the original FAQ has been unchanged.
It's not done, but I think it's time to take it live and make the wiki FAQ our official FAQ, and then remove the old one from the documentation build. Based on the past month alone, I think it's fairly safe to say that it's easier to maintain, update, and keep relevant this way.
I've already sent a patch for lostwages to wine-devel.
Thanks, Scott Ritchie
I've done some heavy modifications and additions to the Wiki FAQ and it's now the "YOU MUST READ THIS NOW!" document pointed to by the #winehq IRC channel so I agree. It's also impossible to edit the old FAQ easily anyway. Some users have been confused though finding two FAQs on the site, so the quicker the old one can be taken down the better.
Ben H.
Scott Ritchie wrote:
So, about a month ago we discussed the idea of replacing the documentation FAQ with one based in the wiki. Nothing was done, but the general consensus seemed to be to wait and see if the wiki approach worked out better.
Since that time, the Wiki FAQ has been updated by 7 people other than myself. We've removed most of the cruft, and taken the FAQ from an unhelpful mess to something a user actually should read. Meanwhile, the original FAQ has been unchanged.
It's not done, but I think it's time to take it live and make the wiki FAQ our official FAQ, and then remove the old one from the documentation build. Based on the past month alone, I think it's fairly safe to say that it's easier to maintain, update, and keep relevant this way.
I've already sent a patch for lostwages to wine-devel.
Thanks, Scott Ritchie
On 6/21/07, Ben Hodgetts (Enverex) ben@atomnet.co.uk wrote:
I've done some heavy modifications and additions to the Wiki FAQ and it's now the "YOU MUST READ THIS NOW!" document pointed to by the #winehq IRC channel so I agree. It's also impossible to edit the old FAQ easily anyway. Some users have been confused though finding two FAQs on the site, so the quicker the old one can be taken down the better.
Ben H.
In the interest of not breaking existing links, can the static FAQ be replaced with a redirect to the wiki version?
On Sat, 2007-06-23 at 11:19 -0500, richardvoigt@gmail.com wrote:
On 6/21/07, Ben Hodgetts (Enverex) ben@atomnet.co.uk wrote:
I've done some heavy modifications and additions to the Wiki FAQ and it's now the "YOU MUST READ THIS NOW!" document pointed to by the #winehq IRC channel so I agree. It's also impossible to edit the old FAQ easily anyway. Some users have been confused though finding two FAQs on the site, so the quicker the old one can be taken down the better.
Ben H.
In the interest of not breaking existing links, can the static FAQ be replaced with a redirect to the wiki version?
It's doable, but it's beyond my ability to change with a simple patch to lostwages due to the weird way the documentation gets built and included automatically.
Could someone else do it?
Thanks, Scott Ritchie