I've pasted the content from the FAQ onto the wiki here: http://wiki.winehq.org/FAQ
I'll spend some time updating it, formatting, and removing cruft this weekend.
What I couldn't figure out how to do, however, was create a patch for wine docs that deletes the actual en/wine-faq.sgml file from the source code, which still lives in a CVS repository. Could someone tell me how to do this with cvs?
Thanks, Scott Ritchie
On Sun, 2007-04-15 at 15:52 -0700, Scott Ritchie wrote:
I've pasted the content from the FAQ onto the wiki here: http://wiki.winehq.org/FAQ
I really don't think this is a good idea: * it's going to be less usable on the Wiki AFAIK * it's going to be fairly hard to edit since it is so big * it changes so seldom that it may as well stay on the main site * we'll lose the other formats (.txt and .pdf)
I think it needs more discussion before we do such a transition. If people agree to remove it, I can remove it from the docs/ package.
On Sun, Apr 15, 2007 at 09:33:41PM -0400, Dimi Paun wrote:
On Sun, 2007-04-15 at 15:52 -0700, Scott Ritchie wrote:
I've pasted the content from the FAQ onto the wiki here:
I really don't think this is a good idea:
- it's going to be less usable on the Wiki AFAIK
- we'll lose the other formats (.txt and .pdf)
MoinMoin Wiki has support for XSLT (currently not enabled on winehq) and thus we could use DocBook XML source directly in the Wiki and thus we wouldn't loose these to features. See http://wiki.winehq.org/HelpOnXmlPages for more information about this.
- it changes so seldom that it may as well stay on the main site
Yes it didn't change because nobody could be bothered to craft a patch. There are already some FAQ entries that accumulated on Wiki pages, e.g. see previous content of http://wiki.winehq.org/FAQ .
Jan
On Mon, 16 Apr 2007, Jan Zerebecki wrote: [...]
MoinMoin Wiki has support for XSLT (currently not enabled on winehq) and thus we could use DocBook XML source directly in the Wiki and thus we wouldn't loose these to features. See http://wiki.winehq.org/HelpOnXmlPages for more information about this.
That would be nice as it would make it easier to handle translations. Is this the approach you're using?
On Sun, 2007-04-15 at 21:33 -0400, Dimi Paun wrote:
On Sun, 2007-04-15 at 15:52 -0700, Scott Ritchie wrote:
I've pasted the content from the FAQ onto the wiki here: http://wiki.winehq.org/FAQ
I really don't think this is a good idea:
- it's going to be less usable on the Wiki AFAIK
Howso? Most people read our documentation (especially when they have a question to ask) by doing a websearch and poking around on our website. Bundling the FAQ with Wine doesn't add too much to this.
- it's going to be fairly hard to edit since it is so big
It's going to be a LOT easier to edit on the wiki then in that horrid monstrous SGML file.
- it changes so seldom that it may as well stay on the main site
It changes so seldom that about half of the entries are obsolete and might even make users more confused after reading than before.
- we'll lose the other formats (.txt and .pdf)
I think it needs more discussion before we do such a transition. If people agree to remove it, I can remove it from the docs/ package.
I brought this up on the list last month (I think), and no one objected so I just went ahead and did it (after being lazy for a month). Anyway, we can talk about it now. I'm gonna go ahead and edit the wiki page (and include the new questions) in the meantime.
Thanks, Scott Ritchie
On Mon, Apr 16, 2007 at 12:00:50AM -0700, Scott Ritchie wrote:
On Sun, 2007-04-15 at 21:33 -0400, Dimi Paun wrote:
On Sun, 2007-04-15 at 15:52 -0700, Scott Ritchie wrote:
I've pasted the content from the FAQ onto the wiki here: http://wiki.winehq.org/FAQ
Hi Scott, Wiki is really a good idea. In the past I've been an opposer of Wiki engines, but nowadays I'm convinced of its usability.
It should be also worhty to make nightly/monthly Wiki dumps to Wine versioning system to be able to distribute the documentation offline, for Wine users without net access.
As modern Wiki engines support PDF and TXT page dumps, the only discussion IMO is how to automate wiki dumps to PDF/TXT/HTML and how to sync regularly with GIT/CVS repository. Sync should be also made before each Wine release.
Thanks Vit Hrachovy
On Mon, 2007-04-16 at 00:00 -0700, Scott Ritchie wrote:
I brought this up on the list last month (I think), and no one objected so I just went ahead and did it (after being lazy for a month). Anyway, we can talk about it now. I'm gonna go ahead and edit the wiki page (and include the new questions) in the meantime.
Well, you maybe right. Let's see how well the new FAQ works on the wiki, and then decide which one to keep.
-
Dimi Paun -
Francois Gouget -
Jan Zerebecki -
Scott Ritchie -
Vit Hrachovy