Blitzortung.org Forum
Should we have a FAQ? - Printable Version

+- Blitzortung.org Forum (https://forum.blitzortung.org)
+-- Forum: Public Forums (https://forum.blitzortung.org/forumdisplay.php?fid=29)
+--- Forum: General Discussion (https://forum.blitzortung.org/forumdisplay.php?fid=31)
+--- Thread: Should we have a FAQ? (/showthread.php?tid=2331)

Pages: 1 2


RE: Should we have a FAQ? - mwaters - 2017-09-26

Hi Brian,

I see you have two 'what's that noise' posts. :-)
Shouldn't there be just one post here?:

Station Hardware and Firmware
Assembly, Setup, Optimization, Feature Requests
Sub Forums: Troubleshooting, Antennas, and 1 more.


RE: Should we have a FAQ? - allsorts - 2017-09-27

(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?


RE: Should we have a FAQ? - mwaters - 2017-09-27

[quote pid='15859' dateline='1506510677']

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?
[/quote]

I thought it was going to be right here, nothing other than the way this site works right now.


RE: Should we have a FAQ? - Rechard83 - 2017-10-19

Nice idea, thanks.


RE: Should we have a FAQ? - EricJohnson - 2018-08-22

(2017-09-22, 23:44)allsorts Wrote: An FAQ would be wondeful, the forum search is, erm, "not very good" or at least I can spend ages trying to make it spit out a topic and or post that I *know* is in there somewhere.

I've had half an idea to pull just my posts together into some form of mini "FAQ", that's why some of my posts go into more detail than is probably required. I can also find all those, relatively painlessly, via my profile.

I quite like Wiki's but they can get out of control, they really need someone to set a style, create suitable templates and tidy up entries to match the style.

As a newbie, I would also suggest that an FAQ would be great for people like me who're just starting out. Right now, I'm trying to gather information from various posts.


RE: Should we have a FAQ? - gerbold - 2018-08-22

Try this: https://docs.lightningmaps.org/doku.php?id=en:support:faq
It is basically a copy of the documentation from System RED but much applies to System BLUE as well.