FAQ: What am I missing?
-
In most cases if you ask a question in the FAQ section you are kindly directed to the forum (by one of the old members/TROLLs). So it is definitely not the forum. But I am also interested how the questions are generated? (I was thinking on the same this morning when I've read through the FAQ)
-
It was answered couple of times AFAIR :) FAQ is generated from trolls internal database and it really differs from forum.
UPD. wow. 4 answers in a row in one minute
-
[quote author="Gerolf Reinwardt" date="1292617784"]The FAQ is generated from the support database of the Trolls. It is not editable by the DevNet users.[/quote]
What is very strange is the big difference in granurality (specificness, detailness) among the questions.
-
There was already a thread on that "here":http://developer.qt.nokia.com/forums/viewthread/1079
-
peppe, the content under menu "FAQ" is fully automatically generated from the Qt docs. The DevNet Trolls (Marius, Alexandra, Gurudutt, etc.) do not have access to change that, but can only request their colleagues.
chrochik, The FAQ is maintained manually. It surely is not based on wether you're a paying customer or not. It's based on the frequency the question is asked - hence F-AQ :-) If something pops up often enough in the various channels, I suspect the Trolls will add the topic.
-
[quote author="Volker" date="1292619597"]peppe, the content under menu "FAQ" is fully automatically generated from the Qt docs. The DevNet Trolls (Marius, Alexandra, Gurudutt, etc.) do not have access to change that, but can only request their colleagues.
[/quote]I know that, and moreover those FAQs do not cover the forums, the wiki and so on. That's why I asked for some unofficial, user-mantained FAQs. Should I assume that there are none? If so, wouldn't it be nice to have them?
-
[quote author="Gerolf Reinwardt" date="1292619621"]Afaik the support is only for commercial customers, isn't it? And a forum is something like FAq or not?[/quote]
No, the forum is certainly not FAQs. OTOH, a FAQs section could be made in the wiki, and things that aren't already in the "official" FAQs and/or are related to the DevNet wiki/forums themselves could go in that section.
-
bq. Marius wrote "here":http://developer.qt.nokia.com/forums/viewthread/1079
To answer the OPs question; the FAQs are edited by the Qt Support team. And each night we get a fresh copy of their FAQ database. The actual source is in the customer support systems we use.I’ve cleaned up some of them, removed the “please fix this / now it’s fixed” comments and removed the tag. But more work is needed there, clearly.
So it comes from the support database. And I think, the support database is dilled by supprt cases?
-
It goes like this: Qt Support (the fantastic Trolls responding to support requests from "paying customers":http://shop.qt.nokia.com/en/support.html) have a support system, this system stores questions that they get with the answers they have. They have had this FAQ database for years and years.
The ones that are thought to be of general good value for anyone gets tagged with "OK to put on the web" or something like that.
Every night we get this set of FAQs over the wire from that support system and we turn it into the FAQ section here. So even though I can edit a FAQ here it's going to be overwritten later.
We have made an RSS feed of FAQ comments that Qt Support checks up on and slowly but surely they are updating the FAQs at the source. And there is a set of tags used by the moderators on the FAQs to identify improvements.
We've had some good old challenges with this, since the source is in pure text with limited or no indentation. All the syntax-highlighting is added by a regex on import and it's not water tight. Also some FAQs have attachments and they don't make it over (and they need a legal check).
I'm thinking of adding some text above the comment box on FAQs, asking that questions should go to the forum but if you have something to add to the FAQ it's great to add it as a comment. Hopefully that would help with expectations, any thoughts?