Should we have a FAQ?
#22
(2017-09-26, 16:21)Pasense Wrote:
  • The FAQ should only be on system blue, because that's where most questions of a general nature will come up.
  • Only relative simple things should be included in the list (see below), specialized technical question will still need to go to the normal forum.
  • The list should be short, otherwise people won't read it anyway. I think it should completely fit onto the screen, say less than 25 lines.
  • The whole effort should be limited and we should gather feedback from readers before considering going on

All sensible, though I assume that the 25 line limit is per question/answer rather than the whole thing! And getting feedback from readers may well be next to impossible.


(2017-09-26, 16:21)pasense Wrote: This list is an example of what could be in such a FAQ:

  1. What do I have to know to be able to assemble and run such a system?
  2. How do I get one of these system blue?
  3. How do I check where I am on the waiting list?
  4. I received the kit, how do I solder the stuff together?

That's the sort of stuff but IMHO 4. would be covered by 1. as that would say you need to be able to solder through hole components to a PCB or know a man who can...  B-)

So we want an FAQ, we have an outline of what it should contain. great but:

Who has access to maintain it?
Open access will have it vandalised within hours....

What software do we use to generate it?
Most CMS systems aren't really suited to this task. I have Perl script I used to make the HTML of an FAQ I wrote/maintained about 15 years ago. Single scrollable file, logically laid out so if read from start to finish told you everything you needed to know. The source is a simple custom tagged plain text file. It's offline but I could put in online for a while, it's plain, it's simple, as it follows "content over form" rather than "form over content" that many sites do these days. The style can be updated of course.

I'm not a fan of a page based systems, you can't search the whole FAQ with your browser for a start and clicking next/back/index buttons that move about the screen depending on answer length is a PITA. Scrolling is so much easier...

And a biggie, where do we host it?
Cheers
Dave.

Stations: 1627
Reply


Messages In This Thread
Should we have a FAQ? - by pasense - 2017-09-18, 09:13
RE: Should we have a FAQ? - by readbueno - 2017-09-18, 10:03
RE: Should we have a FAQ? - by mwaters - 2017-09-22, 20:55
RE: Should we have a FAQ? - by JupiterJoe - 2017-09-18, 15:12
RE: Should we have a FAQ? - by mwaters - 2017-09-18, 16:35
RE: Should we have a FAQ? - by Breitling - 2017-09-18, 17:51
RE: Should we have a FAQ? - by readbueno - 2017-09-18, 18:49
RE: Should we have a FAQ? - by mwaters - 2017-09-18, 20:40
RE: Should we have a FAQ? - by mwaters - 2017-09-21, 20:26
RE: Should we have a FAQ? - by SiriusGen - 2017-09-21, 22:12
RE: Should we have a FAQ? - by mwaters - 2017-09-21, 22:27
RE: Should we have a FAQ? - by readbueno - 2017-09-22, 09:32
RE: Should we have a FAQ? - by kevinmcc - 2017-09-22, 10:30
RE: Should we have a FAQ? - by mwaters - 2017-09-22, 20:34
RE: Should we have a FAQ? - by allsorts - 2017-09-22, 23:44
RE: Should we have a FAQ? - by readbueno - 2017-09-23, 06:57
RE: Should we have a FAQ? - by pasense - 2017-09-26, 16:21
RE: Should we have a FAQ? - by mwaters - 2017-09-26, 17:07
RE: Should we have a FAQ? - by allsorts - 2017-09-27, 11:11
RE: Should we have a FAQ? - by mwaters - 2017-09-27, 13:39
RE: Should we have a FAQ? - by JupiterJoe - 2017-09-26, 17:55
RE: Should we have a FAQ? - by readbueno - 2017-09-26, 18:38
RE: Should we have a FAQ? - by mwaters - 2017-09-26, 21:18
RE: Should we have a FAQ? - by Rechard83 - 2017-10-19, 14:15
RE: Should we have a FAQ? - by gerbold - 2018-08-22, 16:54
RE: Should we have a FAQ? - by Beluga - 2020-01-04, 12:48
RE: Should we have a FAQ? - by mwaters - 2020-01-04, 14:54
RE: Should we have a FAQ? - by Beluga - 2020-01-07, 12:38
RE: Should we have a FAQ? - by dupreezd - 2020-01-07, 22:45
RE: Should we have a FAQ? - by mwaters - 2020-01-07, 15:55
RE: Should we have a FAQ? - by Beluga - 2020-01-08, 11:12
RE: Should we have a FAQ? - by cutty - 2020-01-08, 21:42
RE: Should we have a FAQ? - by mwaters - 2020-01-09, 00:34
RE: Should we have a FAQ? - by cutty - 2020-01-09, 01:25
RE: Should we have a FAQ? - by mwaters - 2020-01-09, 04:30
RE: Should we have a FAQ? - by Beluga - 2020-01-10, 11:15
RE: Should we have a FAQ? - by Danalberto231 - 2023-08-10, 10:32
RE: Should we have a FAQ? - by cutty - 2023-08-10, 12:08
RE: Should we have a FAQ? - by allsodeann - 2024-01-09, 15:27
RE: Should we have a FAQ? - by vinesweather - 2024-01-09, 18:44
RE: Should we have a FAQ? - by Tobi - 2024-01-20, 19:04
RE: Should we have a FAQ? - by astromike - 2024-01-21, 13:32

Forum Jump:


Users browsing this thread: 2 Guest(s)