Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-05 Thread Dr Rainer Woitok
Wolfgang, On Sunday, 2016-12-04 08:43:54 +0100, Wolfgang Thämelt wrote: > ... > > Using a numbered list rather than "##" headers more or less empties > > the "[TOC]" section. > > Yes, of course. But: the manual main page DocMain consists in principle > of the detailed TOC. Now it's my turn

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-03 Thread Wolfgang Thämelt
@Rainer: Some comments to your proposals/remarks: > Using a numbered list rather than "##" headers more or less empties the "[TOC]" section. Yes, of course. But: the manual main page DocMain consists in principle of the detailed TOC. The automatically added [TOC] at the topic of this page

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-03 Thread Dr Rainer Woitok
Wolfgang, On Friday, 2016-12-02 17:04:29 +0100, Wolfgang Thämelt wrote: > ... > please have a look in the QMS wiki! To give you some quick feedback regarding my first impression from just reading "DocMain.html" (I didn't yet get any farther :-): - Using a numbered list rather than "##"

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-03 Thread Dr Rainer Woitok
Oliver, On Friday, 2016-12-02 13:58:40 +0100, you wrote: > ... > The basic stuff is always: > ... [ long list of things omitted ] ... > This is reflected more or less by the current Wiki structure. I agree that your listing includes probably everything currently docum- ented under the "Using

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-02 Thread Oliver Eichler
> As a start I would suggest to move "Command line parameters", everything > "DEM" related, "Working with Projects", "Database", and "GPS Devices" to > the "Advanced Usage" section. This currently leaves "Getting started" > and most (but probably not all) of "Tracks, Waypoints & Co" in the

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-12-02 Thread Dr Rainer Woitok
Oliver, On Wednesday, 2016-11-30 18:29:14 +0100, you wrote: > ... > I agree on splitting the user related stuff into 3 parts. "Basic Usage", > "Advanced Usage", "FAQ" are a good suggestion for the major headlines. My suggestion would be to leave the FAQ in the "Getting Help" section where it

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-11-30 Thread Oliver Eichler
Ok, I had a look. I think, too, that a linear list is better because it's more verbose. You see the list and you know all headlines. You can even search that very easily. I agree on splitting the user related stuff into 3 parts. "Basic Usage", "Advanced Usage", "FAQ" are a good suggestion for

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-11-30 Thread Dr Rainer Woitok
Wolfgang, On Tuesday, 2016-11-29 13:22:14 +0100, Wolfgang Thämelt wrote: > ... > Feedback welcome! Here you are :-) Good ideas: Adding section "Glossary" and splitting "Using QMapShack" into sections "Basic Usage" and "Advanced Usage" (my preferred titles, though I'm open for discussion).

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-11-29 Thread Wolfgang Thämelt
Please look at https://bitbucket.org/maproom/qmapshack/wiki/playground/DocMainTest for a proposal of a possible re-organization of the QMS manual. Feedback welcome! Greetings WolfgangTh --

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-11-22 Thread Oliver Eichler
Hi, the documentation was written with a first time user in mind. That's why the topics start with the "first start" experience and move on to installing/handling maps. Next it explains the general idea behind projects and the 4 elements a project can contain. I recommend to read the wiki up to

Re: [Qlandkartegt-users] What should be contained in the FAQ?

2016-11-21 Thread Günther Bosch
I fully agree. FAQ really should be slim in order to reduce the double effort when updating. I think the best solution is that the FAQ give a short intro into the topic, very general. And provide a link to the actual documentation. Günther Bosch +43 680 3392124 On 21

[Qlandkartegt-users] What should be contained in the FAQ?

2016-11-21 Thread Dr Rainer Woitok
Greetings, since about mid of August Wolfgang has collected a wealth of informat- ion, tips, tricks regarding QMapShack and put it into the various "Doc- Faq*.md" files. But is the FAQ the right place for ANY kind of information? I mean, we could put everything into the FAQ: how to download