Carcassonne Central
December 28, 2024, 05:37:18 pm *
Welcome, Guest. Please login or register.

Login with username, password and session length
News: THESE FORUMS HAVE BEEN REPLACED. PLEASE GO TO THE NEW FORUMS: http://www.carcassonnecentral.com/community/
 
   Home   Help Search Staff List Login Register  
Pages: [1]
  Print  
Author Topic: Organising the FAQ  (Read 12064 times)
0 Members and 2 Guests are viewing this topic.
Scott
Authors
Duke Chevalier
*
*
*

Merit: 45
Offline Offline

Posts: 1538


WWW Awards
« on: January 29, 2008, 10:06:19 am »

…I'm confused by the way the content of the FAQ section is organized. The existing categories don't seem to work well, and it feels like things are duplicated. I suppose duplication is inevitable, but in that regard, the way the FAQ is organized in the Annotated Rules seems to work well: select an expansion, view questions pertaining to that expansion.
« Last Edit: January 29, 2008, 01:01:35 pm by mjharper » Logged

mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #1 on: January 29, 2008, 01:49:17 pm »

Okay, I'm very open to change here. I'll explain the current set-up.

The FAQ actually uses a blog-like structure which allows for categories and tags:

- Categories are 'abstract' and are organised according to expansion, for example, or whether the FAQ is 'live' or out-of-date.
- Tags refer to concrete elements of content, such as builders, crossings, u-turns, and so on.

The first problem of simply associating a given FAQ to single expansion—similar to the way the CAR work—is that many of them refer to the interactions between multiple expansions. For example:

Question: Can I place a builder in a city in which the only other follower is a wagon?
Answer: Yes. A little definition may help: we distinguished between ‘followers’ and ‘special figures’ in the Big Box.
Followers are deployed according to the normal rules and score the normal points. At the moment, that’s the small and big followers, the mayor, and the wagon.
Special figures are deployed differently and have a variable or even no score. At the moment, that’s the builder, the pig, and the barn.


This obviously refers to Traders and Builders and Abbey and Mayor, but also to Inns and Cathedrals. Those are all important categories which the FAQ is catalogued under.

Likewise, builder, wagon, follower, special figure, mayor etc are tags.

The other problem with comparing the FAQ and the CAR is that the CAR is selective: it doesn't present all the FAQ, but only the most relevant. The CAR is intended to be a reflection of the most current state of the rules; the CAR is meant to be comprehensive, and serve, for example, people who aren't interested in being up to date with the latest HiG Big Box rules.
______
So, what to do? I can see good reasons for dividing the FAQ up, say, according to whether you're using RGG or HiG, and/or post/pre Big Box. I can also see the use of dividing them up according to whether they refer to a single expansion, or multiple.

Any other suggestions, please post below.


Logged

Currently residing in the 'Where are they now?' file.
O.M.S.
Freeman
****

Merit: 3
Offline Offline

Posts: 47


Awards
« Reply #2 on: January 29, 2008, 05:28:56 pm »

Matt, would it be possible to gain FAQ in printable form? As document in PDF? It would be nice and suitable reading during wating for tram, bus, train; or especially waiting for her or his; or during boring lectures etc. I think that A7 format would suit me  Wink
Logged
mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #3 on: January 29, 2008, 06:38:11 pm »

I did plan doing a printable version, before I started the CAR if fact. But the problem was exactly what I described above: what about FAQ which cover multiple expansions? There are a lot, and to have all of them duplicated in several places seems like a waste. So I decided to stick with an online 'database' instead.

Still, if I can figure out a way of organising the FAQ more effectively, I think a printable FAQ would be a great idea—and a great addition to the CAR, in fact.
Logged

Currently residing in the 'Where are they now?' file.
Scott
Authors
Duke Chevalier
*
*
*

Merit: 45
Offline Offline

Posts: 1538


WWW Awards
« Reply #4 on: January 29, 2008, 07:19:17 pm »

Some questions definitely are applicable to more than one expansion. Looking at the FAQ Index page, I see a ton of categories, and because some questions fall into multiple categories, they appear more than once.

Now that I've had time to give it some thought, I think I know the solution. The index needs to be split into at least two indexes(?): by expansion, and a topical index. Some categories won't fit in either of these, so more indexes will probably be needed to group related categories.
Logged

dwhitworth
Guest
« Reply #5 on: January 29, 2008, 08:53:51 pm »

Matt
I have been thinking about the reorg of the FAQ and realize that I need more information on it, the CAR, and this forum and how they relate to one another before I can decide if I can make an informed contribution to the discussion. When I joined the site I assumed that the FAQ was a distillation of the forum questions, but now after reading your blog I see it too is a translation of something official published by HiG - and presumably updated by them in response to customer questions(?)

So for one thing, a short explanation in the FAQ of how it relates to the other two resouces would have helped me.

My instincts want to suggest that the three resources (CAR, FAQ, Forum) become more integrated and that they have an easy entry point for newbies and casual readers who want answers on specific issues and who need to know the background of the way the game is published and the way rules are set -as well as providing all the stuff needed Grin by us geeks.  I am not sure that integration is compatible with the current objectives and limits of two items being translations (albeit fabulously annotated ones).

Anyway, it would help me if you could outline how you see the purpose of the three resources and how they relate to one another. If I can get a grip on that I may be able to come up with some more realistic ideas for the FAQ organization.

Logged
mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #6 on: January 30, 2008, 03:20:05 am »

FAQ

One of the problems here is that the FAQ section has been, well 'unfinished', for several months. It's supposed to contain a lot more detail—detail which was available  at some time in the past, but which I just haven't got round to re-implementing.

The original reason the FAQ—and this is some 3 years ago—was I noticed that questions kept coming up on the BGG forums which had already been answered by HiG; but HiG had answered in German, and only a few of the members on HiG were both aware of this and able to read the FAQ that had been posted. So I decided to translate everything on the official homepage, ordered in exactly the same way. That's why there isn't a single category for the basic game: because the homepage divided them into sub-groups.

Anyway, I after that the FAQ expanded with each new expansion, and acquired something of a reputation. Not exactly for authority—because as people have pointed it, even correspondence with a direct employee of HiG doesn't necessarily entail being 'definitive' (we've had conflicting responses from different employees, in fact) but for being as comprehensive as possible, and certainly something you could link to if you wanted to back up your arguments (and that linking is one reason why I won't be making a list of questions on a single page). Between my site and John Sweeney's—which works on a similar principle—you should be able to find out most anything you need to know.

Incidentally, the last time I wrote to HiG they wrote back asking if they could refer to my FAQ as they set about re-building their own site…

The problem with the FAQ is it's been through three versions—on blogger, in iWeb, and now in RapidWeaver—just like all my other sites have in the same period. Transferring everything is a monumental effort, and I haven't yet moved everything I should have. So the FAQ should, for example, contain all the original German texts that I've based the translations on, as well as commentary on status.

CAR
As I said in the introduction recently added to the CAR, it came about when then Big Box was released (18 months ago?). We could all see that there had been a number of changes in the rules, and people wanted to know what they were—both for HiG and RGG. And it seemed natural enough that I do the translations, having done the FAQ. As I went through I added notes about comments about changes, implications, and relevant FAQ. Once complete, the document naturally expanded to cover all the expansions, and then to included a bunch of things which like the Consolidated Tile Reference. I still wanted to keep everything 'official'; or at least keep clear what was translation, and what was commentary. You wouldn't believe the number of times, in the early days of the FAQ, that someone would post a comment simply saying, "Wrong!", and I'd have to regurgitate some spiel about it not being wrong, because it was a translation of an official answer to the question… Anyway, the main reason why the CAR doesn't contain much user-created content is because, apart from statistical stuff like the Tile Reference, it was still all translations. The variants that are included are all translations from a document on the official homepage.

Forums
About a year ago, Gantry approached me about a collaboration here on CarcassonneCentral. He hadn't been aware of what I'd been up to, but it was clear that, if CC went ahead as he planned, there'd be a certain amount of overlap—so why not bring it all together? We beat out a few details—I couldn't work on something that recommended the RGG rules (acknowledge, but not recommend), and I wanted to keep to FAQ semi-independent. We decided to lock the downloads away in a password protected area to encourage people to join. And most importantly, the forums generated a community, something there's no way I could have achieved with my blog-based site.

Future
I feel that, a year on, what we both brought to the table has helped each other. Now what we're trying to to is simplify and integrate the site somewhat—strive for a clearer, more identifiable design, remove duplications (you'll notice that you can't log in from the front page anymore—that whole are is being vastly overhauled) and focus on the main strengths of the site.

More specifically, I don't envisage a huge change to the FAQ. The section needs to be finally finished, and it needs to be reorganised to make finding things easier; but I don't see the need for a new approach. I do see the need for spelling out more clearly what the approach actually is, and I'll probably have to create an 'Introduction', just like I did for the CAR.

I do think the CAR should be expanded beyond its current scope. I still don't want to change the nature of the rules themselves—they are translations, and should remain that way, supplemented by extensive notes. But I do feel that there should be more user content—and that becomes possible in conjunction with the forums, and the rest of the CC site. Instead of me picking stuff I like, we can much more easily open the doors to community suggestions, and that's great. I'll just have to split the document between 'official' and 'user' content. My rebuilding of the CAR—which is going to take some work—is setting the ground for that development.

And the site itself (that is, all it's component parts) will be having a re-launch soon too—that's in the works.

Well, I hope that clarifies these things a bit.
Logged

Currently residing in the 'Where are they now?' file.
mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #7 on: January 30, 2008, 03:22:59 am »

Some questions definitely are applicable to more than one expansion. Looking at the FAQ Index page, I see a ton of categories, and because some questions fall into multiple categories, they appear more than once.

Now that I've had time to give it some thought, I think I know the solution. The index needs to be split into at least two indexes(?): by expansion, and a topical index. Some categories won't fit in either of these, so more indexes will probably be needed to group related categories.
That might be tricky, since the index is automated… I'll see what I can do. But doesn't your suggestion involve the division between category and tag I outlined above? Wouldn't streamlining these lead to the same result?
Logged

Currently residing in the 'Where are they now?' file.
Scott
Authors
Duke Chevalier
*
*
*

Merit: 45
Offline Offline

Posts: 1538


WWW Awards
« Reply #8 on: January 30, 2008, 10:47:06 am »

The way you've outlined it above, yes, but that's not the impression I get from looking at the existing FAQ site. Right now I'm just approaching it from a content point of view and mostly ignoring implementation details because they depend on how you/we think the content should be organized. The organization should correspond with the user's thought processes and allow them to narrow things down quickly. At the moment, the number of categories is overwhelming, but if they are grouped, the user can select the group which matches their train of thought.
Logged

dwhitworth
Guest
« Reply #9 on: January 30, 2008, 12:16:31 pm »

Thanks for the overview Matt. Some of that would be really useful to know when a person first visits this site. Thanks for the reference to John Sweeney's site - another bit of research for me to do is read all that  he has there.

The ideas for the future of the CAR and the site all seem great plans and I look forward to seeing what results (and maybe contributing in a small way sometime.)

The only thing I am not clear about is how and when the FAQ is updated. Do you scan the HiG site and add new stuff that appears there, and/or do you add material that seems to you to be appropriate? Maintenance effort may have some bearing on the suggestions about how to organize it.

I am away for a couple of days and will think about this some more and post any ideas that occur to me.

 
Logged
mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #10 on: January 30, 2008, 02:45:19 pm »

The way you've outlined it above, yes, but that's not the impression I get from looking at the existing FAQ site. Right now I'm just approaching it from a content point of view and mostly ignoring implementation details because they depend on how you/we think the content should be organized. The organization should correspond with the user's thought processes and allow them to narrow things down quickly. At the moment, the number of categories is overwhelming, but if they are grouped, the user can select the group which matches their train of thought.
Yes, I see that. I'll have a think about it. Any suggestions are more than welcome.

Thanks for the overview Matt. Some of that would be really useful to know when a person first visits this site. Thanks for the reference to John Sweeney's site - another bit of research for me to do is read all that  he has there.

The ideas for the future of the CAR and the site all seem great plans and I look forward to seeing what results (and maybe contributing in a small way sometime.)

The only thing I am not clear about is how and when the FAQ is updated. Do you scan the HiG site and add new stuff that appears there, and/or do you add material that seems to you to be appropriate? Maintenance effort may have some bearing on the suggestions about how to organize it.

I am away for a couple of days and will think about this some more and post any ideas that occur to me.
Updates to the FAQ—which are behind schedule—are currently based on correspondence with HiG. Their site is in a constant state of being updated, and has been for some time; the last expansion they catered for was Princess and Dragon.
« Last Edit: January 30, 2008, 02:47:42 pm by mjharper » Logged

Currently residing in the 'Where are they now?' file.
dwhitworth
Guest
« Reply #11 on: February 01, 2008, 02:28:30 pm »

When I approached the current FAQ for the first time, (and now when I went there to form some opinions on the re-org) I noticed three things that seem to add to my confusion. These may not be easy to fix, so I just offer them as food for thought.

First:  I was instinctively looking to solve a problem in game play at a certain point in the sequence of play. It occurs to me that a key to the FAQ based on the stages of the sequence of play might help a user to get to their answer quickly. So, the entry points would be something like:


  • Set up
  • Choosing starting player
  • Starting tile, City, River - before regular turns
  • Pre-tile turn activity – Fairy, prisoner buy-back
  • Tile selection and placement
    • Abbey vs land tile, incl. end of game rules about Abbeys
    • Placement of shrines/cloisters
    • Longest road/largest city
    • Trade goods token assignment
  • Deploying game pieces
    • Dragon to volcano
    • Meeple placement
    • Tower block placement
    • Removal due to princess
    • Fairy move
  • Dragon movement
  • Scoring during turns
  • Meeple movement due to Cathars and city of Carcassone
  • Returning followers to supply
  • Extra turns due to Builders
  • End of turn
  • End of game
  • End of game scoring

It seems to me that being able to get an answer keyed by one of these stages might correspond to what many people are trying to do when they have a question.


Second; The depreciated FAQs often come up mixed among ones that are valid/provisional or incorporated and it is not clear whether they are valid or not. This was really confusing to me as I thought I was seeing contradiction among the answers. I didn’t really understand the issues of rule versions or whether pigs and builders were followers or not until I had read the CAR much later. I understand that the depreciated stuff needs to be there for completeness and so that people can understand the history if they are interested, but can the depreciated material be archived into a separate space for reference and not be indexed so that it comes up when searching for relevant material. In addition there may be an indication in a new ruling answer that links to the related depreciated one. Depreciated answers should probably have a clear indication in their text [in colour, in italic caps  Grin] so that it is clear that they are currently invalid.

Third: When a search produces a list of questions labeled simply by a topic and question number (eg: “expansion “x” question 10, Expansion “x” Question 12 . . . .) then the reader has to read through them all to see if there is anything relevant to their question. A full text search might get around this somewhat, but if the FAQs had title lines indicating the topic more specifically, and if these appeared in the index listing, a lot of searches would be faster.

Other issues with the FAQ organization that I found difficult are being dealt with by other commentators.

Hope this helps.

Logged
Gantry
Administrator
Chatelain
*
*
******

Merit: 20
Offline Offline

Posts: 1159


taken


WWW Awards
« Reply #12 on: February 01, 2008, 02:58:58 pm »

Actually your sequence of play comment strikes me as exactly how I've used it about half the time. I don't see reorganizing material as being very likely, perhaps instead there could be a page that shows this sequence of play order with page numbers.  Kind of like a second table of contents.
Logged

Have ideas for Carc Central?  PM me!
mjharper
Administrator
Baron
*
*
*
*****

Merit: 25
Offline Offline

Posts: 939



WWW Awards
« Reply #13 on: February 01, 2008, 05:38:01 pm »

Thanks for the suggestions. I'm not sure how practical 1) is, but we clearly need a different method. I think about it…
Logged

Currently residing in the 'Where are they now?' file.
Pages: [1]
  Print  
 
Jump to:  

Powered by MySQL Powered by PHP Powered by SMF 1.1.16 | SMF © 2011, Simple Machines Valid XHTML 1.0! Valid CSS!