Hard Light Productions Forums

General FreeSpace => FreeSpace Discussion => Topic started by: karajorma on August 24, 2004, 03:33:53 pm

Title: What do I do with the FAQ?
Post by: karajorma on August 24, 2004, 03:33:53 pm
Been having a rather trying day here. The last couple of days I've been trying to update my FAQ but I'm finding it pretty hard going.

The FAQ was originally written when FS2 had been out a couple of years. Nothing much changed so it was pretty easy to go through my VBB postings and put together a FAQ. Since nothing much changed it was pretty easy to maintain it.

However over the last few months two things have caused me to rethink my attitude to the FAQ.

1. The Wiki is a more comprehensive source of information and it seems rather foolish to try and compete with that.
2. The SCP moves so quickly that there is no way the FAQ could keep up with it.

The result is a big problem for me. I hate leaving the FAQ up when it is full of information which is now incorrect. I really hate pointing someone at it when I know that the info on it could mislead or confuse but maintaining it so that it doesn't get old is a real case of running to stay still.

So I'm stuck as to what I should do with it.
Title: What do I do with the FAQ?
Post by: kode on August 24, 2004, 03:46:58 pm
move it to the wiki and also Turn it into a HLP Digest with answers to Questions posed on the forums
Title: What do I do with the FAQ?
Post by: magatsu1 on August 24, 2004, 04:18:38 pm
keep the turret and table tutorials for sure. (I need them!)
Title: What do I do with the FAQ?
Post by: karajorma on August 24, 2004, 04:27:06 pm
The turret tutorial would definately remain in some form or other. Possibly moved to the wiki but I definately wouldn't delete it until someone writes something to replace it.

The intro and HotU pages will also definately survive cause they are indexed elsewhere and I don't want people coming to the FAQ finding it gone and then being stuck.
Title: What do I do with the FAQ?
Post by: WMCoolmon on August 24, 2004, 05:07:25 pm
Voted move the entire thing to the wiki, since then you would potentially have other people to help you maintain it.

*Checks wiki changes list*

Though that might just be a pipe dream...
Title: What do I do with the FAQ?
Post by: Ace Pace on August 24, 2004, 05:30:28 pm
I would keep it mostly there, with a warning some stuff, like SCP, is out of date.
Title: What do I do with the FAQ?
Post by: Xelion on August 26, 2004, 11:11:30 pm
Keep it all there :yes:. Although I would move all the old FAQs in an archive, and all the ones still current (leave them exactly where they are now) and any additions made in the future. Why? There are links all over the net to the FreeSpace Oracle and its subpages, removing it would be havoc and even redirecting it might still throw some people off.
Title: What do I do with the FAQ?
Post by: karajorma on August 27, 2004, 04:10:07 am
Yeah. I'd never yank the Oracle without making sure that all the pages forwarded elsewhere.

For a start I know a lot of HotU people end up here precisely because of the FAQ.

The consensus seems to be towards moving things over to the Wiki which is something I'm fine with. I like the idea of having an archive. A lot of the information that is outdated is still useful to people who can't or won't run the SCP.
Title: What do I do with the FAQ?
Post by: Cetanu on August 27, 2004, 04:24:12 am
At least I will get sentimental when there is no separately Oracle left. I forwarded lots of people to it too... anway, good job kara! :)
Title: What do I do with the FAQ?
Post by: Xelion on August 27, 2004, 06:03:58 am
No offence :) intended... but the Oracle seems more inviting and less distracting then the Wiki, I thinks its the colors :nod:. Maybe the Wiki should adopt a better color scheme.
Title: What do I do with the FAQ?
Post by: Pilot Of The US on August 27, 2004, 06:12:00 am
I think you should update the FAQ as much as you can and leave a warning about possibly incorrect infomation or infomation that is likey to change in the future. Also leave out questions that are extreamly hard to keep up to date.

Oh can you please complete the turreting tutorial, coz you stated at the end of the tutorial the following :
Quote
I intend to add to this FAQ details on how to add engine glows, paths and even fighter bays and docking point to the GTC Great Big Cube
Title: What do I do with the FAQ?
Post by: karajorma on August 27, 2004, 07:22:31 am
Yeah. I noticed that while I was looking at it last week :) I will have to explain that stuff, maybe with a more detailed model though :)
Title: What do I do with the FAQ?
Post by: Setekh on August 28, 2004, 03:16:12 am
Front page. :)
Title: What do I do with the FAQ?
Post by: karajorma on August 28, 2004, 03:27:20 am
Thanks :)

Can't hurt to get some more opinions on the matter :)
Title: What do I do with the FAQ?
Post by: TopAce on August 28, 2004, 04:32:42 am
Any ideas if anyone visits the Wiki at all?
By the way, the FRED Help documentation which I wrote more than a year ago is not uploaded anywhere. Do you still need it? If yes, I can upload it and put it into HTML format.
Title: What do I do with the FAQ?
Post by: karajorma on August 28, 2004, 06:39:02 am
I think it would be useful to have it. Especially with this whole newbie training thing going on.  :)
Title: What do I do with the FAQ?
Post by: TopAce on August 28, 2004, 06:58:35 am
Wait ... I can put it into the Wiki. Or should I host that somewhere else(swooh?) and put it into HTML format?
Title: What do I do with the FAQ?
Post by: karajorma on August 28, 2004, 07:02:28 am
Put it into the wiki if you can. :)

The only problem with the wiki is if you need any images hosted cause you'll have to keep them elsewhere for now (Or contact one of the admins with a zipfile of the pics you want)
Title: What do I do with the FAQ?
Post by: TopAce on August 28, 2004, 07:03:41 am
It's a bit more complicated than that ... discuss it via ICQ in the afternoon, ok?
Title: What do I do with the FAQ?
Post by: karajorma on August 28, 2004, 08:31:34 am
No problem.
Title: What do I do with the FAQ?
Post by: Pilot Of The US on August 29, 2004, 04:37:41 am
Your FAQ is downloadable in a package isnt it?

How come the wiki isnt, i mean i'd love to download it and browse through it offline. But i guess the reason is coz it's updated too often (am i right?).
Title: What do I do with the FAQ?
Post by: TopAce on August 29, 2004, 04:38:45 am
The Wiki is not updated often. Look at the Recent changes window. It rather became an SCP FAQ than a FreeSpace Modding manual. When things get updated at the SCP, it goes there.
Title: What do I do with the FAQ?
Post by: Xelion on August 29, 2004, 05:02:09 am
Quote
Originally posted by Pilot Of The US
Your FAQ is downloadable in a package isnt it?

See what I mean :), isn't it obvious that things are better when you can download them at least in its minimal form if possible.


Quote
Originally posted by Pilot Of The US
How come the wiki isnt, i mean i'd love to download it and browse through it offline. But i guess the reason is coz it's updated too often (am i right?).

Like TopAce said, it's not updated often but its not downloadable because that would defy its natural concept, an online (often updated - not currently) encyclopaedia of the Freespace Universe.
Title: What do I do with the FAQ?
Post by: Pilot Of The US on August 29, 2004, 11:18:15 am
@kara - Keep your FAQ online as it is and update it as much as possible. If you a question is too hard to answer, link it to the wiki. I really like the whole downloadable package thingy.

@Xelion - Why cant we change the concept of the wiki to a "online, downloadable encyclopedia of the freespace universe?"
Title: What do I do with the FAQ?
Post by: karajorma on August 29, 2004, 03:54:59 pm
Quote
Originally posted by Pilot Of The US
Your FAQ is downloadable in a package isnt it?


I didn't know that there was that much demand for the downloadable version but yeah. The current download might be a little bit out of date though (Well more out of date than the rest of the FAQ). I'll change things around when I finally get around to the big upgrade I'm planning.
Title: What do I do with the FAQ?
Post by: Xelion on August 29, 2004, 11:22:59 pm
Quote
Originally posted by Pilot Of The US
@Xelion - Why cant we change the concept of the wiki to a "online, downloadable encyclopedia of the freespace universe?"

You would need some kind of plug-in/server side-script for that I believe. Its possible although I'm not the one to contact on this, Lonestar or Sandwich is. :)
Title: What do I do with the FAQ?
Post by: Pilot Of The US on August 30, 2004, 01:29:48 am
huh. But kara made his FAQ downloadable so easy just by saving his website into a zip file. Cant we use the same technique to make it into a downloadabe package. And say every 3-6 months a new package is compiled.
Title: What do I do with the FAQ?
Post by: Xelion on August 30, 2004, 04:51:01 am
Its a Wiki not a website, I don't exactly know what the Wiki is based on, it might be possible, but every 3-6 months is pointless as data is updated quite frequently in some circumstances. I'm still not the one to contact about this, I don't operate or maintain the wiki. If I did it would be online just as is now but include several more features mostly because there are some features that can not be included in a download :).
Title: What do I do with the FAQ?
Post by: karajorma on August 30, 2004, 06:41:09 am
My FAQ is also signifacantly smaller than the wiki :D
Title: What do I do with the FAQ?
Post by: TopAce on August 30, 2004, 06:45:50 am
New link to my FRED Document:
http://www.swooh.com/peon/TopAce/FSHelp.html
Title: What do I do with the FAQ?
Post by: GT-Keravnos on August 30, 2004, 02:29:34 pm
@ Karajorma, do take some time with your FAQ, placing entire parts of it in Wiki, and changing/scraping others as needed.

Thing is information overlap is good for the soul... :D
Title: What do I do with the FAQ?
Post by: karajorma on August 30, 2004, 03:18:57 pm
I don't object to taking some time to fix the FAQ. What I'm worried about is that I'll have to do it again 3 months down the line.

The SCP is moving so fast that certain parts of the FAQ get old very quickly.
Title: What do I do with the FAQ?
Post by: Pilot Of The US on August 31, 2004, 01:05:07 am
Yeah,  i see your problem. Maybe you could have special 'update news' page where you can quickly announce the new stuff, link it to the wiki, and leave a warning on your FAQ that you only update it a few times a month or something like that.

Really love your download feature!