Dan Kegel wrote:
Recently, several newbies had trouble finding the FAQ and were surprised to hear that it could be helpful. Perhaps if our packages added a "Wine FAQ" menu item, they'd have less trouble finding it.
Here's a patch to add that to the Debian / Ubuntu packages. What do people think?
--- /dev/null 2008-05-31 06:33:17.000000000 -0700 +++ debian/wine-faq.desktop 2008-07-22 00:06:29.000000000 -0700 @@ -0,0 +1,8 @@ +[Desktop Entry] +Name=Wine FAQ +Comment=Frequently Asked Questions about Wine (and their answers) +Exec=xdg-open http://wiki.winehq.org/FAQ +Terminal=false +Type=Application +Icon=gnome-help +Categories=Wine; --- debian/rules.orig 2008-07-22 00:11:37.000000000 -0700 +++ debian/rules 2008-07-22 00:12:32.000000000 -0700 @@ -160,6 +160,7 @@ cp -f $(CURDIR)/debian/wine-notepad.desktop $(CURDIR)/debian/tmp/usr/share/applications/ cp -f $(CURDIR)/debian/wine-browsedrive.desktop $(CURDIR)/debian/tmp/usr/share/applications/ cp -f $(CURDIR)/debian/wine-winecfg.desktop $(CURDIR)/debian/tmp/usr/share/applications/
- cp -f $(CURDIR)/debian/wine-faq.desktop
$(CURDIR)/debian/tmp/usr/share/applications/
mkdir -p $(CURDIR)/debian/tmp/usr/share/desktop-directories/ cp -f $(CURDIR)/debian/wine-wine.directory $(CURDIR)/debian/tmp/usr/share/desktop-directories/
I have a few reservations.
The FAQ is english only, it's a web site (unlike all other documentation), and it contains a lot of unrelated information like stuff for newer versions or other distros.
Ideally, of course, users shouldn't have to read anything before being able to use Wine. For Intrepid I'm working on cutting down on as much of the non-obvious stuff as possible (for instance you'll be able to double click on .msi files now that I've added an entry for them in shared-mime-info).
As an alternative, I suggest that near release time we consider forking the FAQ, trimming all the unrelated stuff, polishing it up a bit, and bundling that as proper documentation (including being indexed by scrollkeeper and friends).
Additionally, there are some other documents we should update first and have them point to the Wine FAQ, most notably the pages on Wine in the Ubuntu Wiki and the sticky threads at the top of the Ubuntu Wine forum. Which reminds me, I still don't have moderator rights there...
Thanks, Scott Ritchie