Locus Map - forum

Development => Discussion/New features => Manual & Help desk system => Topic started by: menion on December 09, 2012, 10:32:12

Title: Discussion about Locus manual (Dokuwiki)
Post by: menion on December 09, 2012, 10:32:12
I would like to discuss with you little bit a content of wiki site. As content grow, I'm getting feeling that this site is going to be little bit confusing. Mainly one major part. I'll not discuss here if site is actual etc. but rather some content, distribution of pages

Current sections

Screens - I have nothing against it. It contains list of all core screens and shorter list of smaller once. I think it's a good start point for users and may contain some screens that repeat on more places or some that aren't directly features in list of features etc...

Functions - ordered list same as in app. I like this and see no reason to change

Settings - same as with functions

Store - this is "separate" part. Locus Store itself will need huge improvements, but it depend mainly on server. So here is plan work on server (expected January - cca April 2013), then (mabye together with server) change in Locus itself and then finally change in Dokuwiki, so leave it be for now

Last two are that I worry about. There is no precise difference between Various and Community and I would like to discuss with you possibilities and some better solution. Firstly, I think there is no need to separate posts that did community and that wrote me, Hanka or Peter. Secondly there isn't clear which part contain which information.

Currently some possible categories
- How to do some specific tasks
- Customizations (modifications, icons, voices, config file)
- Maps (transformations, MOBAC, etc., deserve separate topics)
- Geocaching (also deserve separate topics)
- Common problems and solutions
- Interesting and useful links
- various

nice should be to separate it into two major categories (as are now "Various" and "Community" and in these categories do some table of content as now

discussion is welcome. Because new Locus homepage will not contain any manuals or any specific information, I really would like to have wiki site as much user friendly as possible
Title: Re: Dokuwiki content
Post by: berkley on December 09, 2012, 16:26:38
For some specific reason I think it's not too bad to follow some unwritten rules for android apps...
Can you imagine some layout similar to that?
https://play.google.com/ (https://play.google.com/)
Title: Re: Dokuwiki content
Post by: menion on December 09, 2012, 16:32:24
hmm don't understand how this helps. I'm not thinking about design of Locus Store but about general scheme of documentation for locus
Title: Re: Dokuwiki content
Post by: berkley on December 09, 2012, 16:52:47
I was thinking about the same, but probably you're right, let's have a look at the layout later...

For the start, I would merge all topics from "Community" into "Various". Problem is, that topics increase from time to time. So there has to be a clear structure. If you want to stay with that folder structure, you can try something on your desktop PC...

For every topic create an empty file just with the name of the topic. Then create folders for every category. At last, open 2 file browser windows and move every topic into the specific category.
Title: Re: Dokuwiki content
Post by: menion on December 09, 2012, 17:08:20
eh guys (matthias) :)

I probably wrote it too long in first post :)

I wanted to say, that all is fine on wiki expect two sections, "various" and "community". What I need is idea, how to create structure of one merged category or two new categories ...

like for example, instead of "various" and "community", something like

How to (first new category in main menu - focused on "tutorials")
  - how to do geoaching
    - 1. topic about geocaching
    - 2. topic about geocaching
  - how to use navigation
    - 1. topic ...
    - 2. topic ...
  - how to create/convert/modify maps
    - 1. topic ...
    - 2. topic ...
  - how to something others
    - 1. topic ...
    - 2. topic ...

Various topics (second new category in main menu)
  - customization
    - 1. voices
    - 2. icons
  - common problems and solutions
    - 1. topic ...
    - 2. topic ...
  - interesting and useful links
    - 1. wms ...
    - 2. topic ...

so I thought about something like this ...
Title: Re: Dokuwiki content
Post by: voldapet on December 17, 2012, 17:26:39
Agree with Menion
- Add new category  “How to” (I have problem and I want to solve it. I don’t want to read five pages about screen and functions)
- “How to" will be first category on home docs page[/list]
- Rearranging “Community” and “Various” to the one category “Various”.
Title: Re: Dokuwiki content
Post by: gynta on December 17, 2012, 19:45:56
Quote from: "voldapet"
Agree with Menion
- Add new category  “How to” (I have problem and I want to solve it. I don’t want to read five pages about screen and functions)
- “How to" will be first category on home docs page
- Rearranging “Community” and “Various” to the one category “Various”.

Agree - but a "how to" also has to be divided into sections...

To find a function or an setting - the current system is ok

About "Community" and "Various": few weeks ago i talk with Menion - but he have his own idea...

I think we have not a big problem with current dbase.
First we should write all the missing pages...
You should always adapt the documentation to the latest version before it is published.
Title: Re: Dokuwiki content
Post by: berkley on December 23, 2012, 21:30:49
Does somebody wants to go trough all the topics from "Questions & Answers", find out some troubles that have been solved and create a "F.A.Q." topic with this content on the wiki???

:D
Title: Re: Dokuwiki content
Post by: menion on December 23, 2012, 21:35:14
don't worry about it :) We have quite clear imagination about which questions need to have it's FAQ topic. Mainly because much more topics is solved by emails. So I'll for sure prepare some table of content for "How to" part during a holidays

And btw. nice article about OSM mapping. Seems you really like it ;)
Title: Re: Dokuwiki content
Post by: berkley on December 24, 2012, 07:55:06
Quote from: "menion"
And btw. nice article about OSM mapping. Seems you really like it ;)

Thanks, feel free to use it for improving the relationship with OSM...  :mrgreen:
Title: Re: Dokuwiki content
Post by: tommi on December 28, 2012, 15:40:34
Menion,
I have registered for mail on update of the wiki pages.
From a mail almost everyday I see that there is really good progress in this area and more and more pages are getting updated.
But  since some time the sender address for this mail is missing and so these mails always go into spam folder.
Could you change that?

Thanks,
Thomas
Title: Re: Dokuwiki content
Post by: menion on December 28, 2012, 19:29:48
hi Toomi, so you now suffer from enormous number of emails, enjoy it ;)

I have checked settings on dokuwiki and seems there is possible to set email address that will be in "send from", so check it next time ...
Title: Re: Dokuwiki content
Post by: tommi on January 01, 2013, 08:58:57
thank you for the fix, now I receive the mails again.
Title: Re: Dokuwiki content
Post by: gynta on February 02, 2013, 14:04:33
About "How to (http://http://docs.locusmap.eu/doku.php/manual:how_to)"
Should this be created similar as an "FAQ" ?
In this case we need to have much more "noob" topics.

current situation is:
"Hey guy, you have some questions?:
hm maybe you find some answeres here on docs.locusmap.eu (http://http://docs.locusmap.eu/doku.php/manual:main) or here on getsatisfaction.com (http://https://getsatisfaction.com/locus) or here on forum.locusmap.eu (http://http://forum.locusmap.eu/index.php) or here on facebook.com (http://https://www.facebook.com/locusmap) or per mail locus@asamm.com - have fun!"
Title: Re: Dokuwiki content
Post by: gynta on August 30, 2013, 16:22:59
Dear Premium stuff  :)

After few month - in the end some "How to" topics are done. (not puplic yet):
Thanks for beginning!

#I don't know if it's a good idea to squeeze into rigid categorys.
For a new user its not possible to search/find a problem(answer) inside twenty categorys.
because he is new! and has no idea where he should search for.
wiki has an good "serch function" - this can do the job for a new user well but this would require a better input mask

#and last but not least - let us also discuss about missing FAQs
If we look inside getsatisfaction.com and the forum, we will find lot of questions/answeres.
So please help zdrazil and let him know what is missing.

nice weekend
Title: Re: Dokuwiki content
Post by: balloni55 on August 31, 2013, 19:55:01
For me also unknown and coudn´t find an answer:
- •   The theme “BIN” in the forum, is this an abbreviation or what is the meaning?
- •   For what is the Karma, red and green arrow? Refers it on these post or generally to these member? and how to use?

nice weekend

sorry for these structure, i have some problem with the "handling" of new forumssoftware :-[
Title: Re: Dokuwiki content
Post by: menion on September 02, 2013, 06:08:58
Hi guys,
  firstly, thanks for your interest. Nice

  content of new wiki will be here http://docs.locusmap.eu/doku.php/playground:main_new . Vladimir Zdrazil (zdrazil) is just a new guy we hired for such extra tasks like writing wiki etc. I really do not have time on this and also my English isn't best for manual ...

  Hmm presentation of admins :) I'll think about it ... meanwhile you may scroll "Our team" panel here http://www.asamm.com/

  Meaning of "BIN" - it's just trash for testing and playing with this forum. Everything that may be deleted belongs here
  "Karma" - it's just a feature of this forum. From my personal point of view, it's useful to see that person may be "trusted" and users are satisfied with it's responds, so they may vote him. You may check ivolino ( http://forum.locusmap.eu/index.php?topic=3292.msg23384#msg23384 ), it's nice example that it works. He had many questions again and again same, even a little unpatient and you may see his karma. Btw. I see gynta has also just "-1", heh :)

  Anyway if you think it's a nonsense, I may remove it, but ... I like it. It makes from forum also a small playground and it's "fun".
Title: Re: Dokuwiki content
Post by: gynta on September 03, 2013, 20:05:20
Karma is nice but I can't see why my karma is changed.
More useful is a "thank you" plug in.
I think...
Title: Re: Dokuwiki content
Post by: tramp20 on September 04, 2013, 13:21:38
Karma is nice but I can't see why my karma is changed.


I did it :-)
Title: Re: Dokuwiki content
Post by: balloni55 on September 08, 2013, 14:20:21
Quote
  content of new wiki will be here http://docs.locusmap.eu/doku.php/playground:main_new . Vladimir Zdrazil (zdrazil) is just a new guy we hired for such extra tasks like writing wiki etc. I really do not have time on this and also my English isn't best for manual ...
Hi menion
in the meantime i read some of the new written chapters from zdrazil and i´ll be sure all users are happy with an "up to date" manual :)
For this time i have a question:
under "Getting startet" there is discribed how to load more than 3 geocaches/day as a basic member with cgeo :o
Wolfgang
Title: Re: Dokuwiki content
Post by: menion on September 10, 2013, 17:52:48
if it's good or not it's a question ...

I think about it in this way:

1. c:geo violate "terms of use" of Groundspeak
2. Groundspeak knew about it and do absolutely nothing!!
3. users suffer in all apps except c:geo, because of quite stupid limitation, that almost broke ability to hunt a caches
4. Because Groundspeak knew about it and do nothing, then why not use this app as data source

You probably know me and I'm not a fan of violating terms of use of any service. On other side, when I don't agree with something, I don't care too much about law. In this case, I don't agree with limits from groundspeak for basic members. People are creating this game, not Groundspeak, and 30$ per year is quite a lot of money compare to prices of apps on Android. Also, their app do not have these limits, weird, isn't it?

So Vladimir (zdrazil) ask me on this opinion, and I said, why not. When Groundspeak ask me to remove it, I'll remove it in case, they block c:geo (oki, maybe even without it :) )
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: gynta on June 30, 2014, 20:36:47
Reactivated thread,
because Locus knowledge base (http://docs.locusmap.eu/doku.php?id=manual:main) will be updated soon...
Any ideas, opinions or suggestions for improvement?
Feel free to tell us...
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: menion on June 30, 2014, 21:26:30
To be precise, currently around 80% of stuff is back and most of it updated and some added.

As I discuss at home with Peter and Hanka, this is how we like new structure.

main sections
Section "how to" with most easy manuals as "Gettings started", few FAQ and basic manuals
Section "user guides" with more detailed descriptions of Locus screens
Section "Advanced" with rest advanced topics

Anyway there is always place to make it better, so as gynta wrote, feel free to discuss about it. Because I believe everyone from time to time find good manual useful. Me too to be true  ;).

And step that will follow (we plan)
 - we will work on Czech translation
 - will try to find native English speaker (finally) to create perfect English translation (also for Locus itself)
 - will try to find native German speaker to create perfect German translation.

If you know about anyone who is interesting in English or German, give him contact. And warning - we want really 'nice translation' as a paid! service, not for free. Because it needs to be "perfect" and it has to be fast. I'm sure everyone waited too long on manual.
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: berkley on July 02, 2014, 15:34:03
Perfect, glad to hear about switching back to old solution.

How do plan to face the problem with creating new features, changing layouts and so on? Manual will always be one step behind the app.

Best solution should be:
- get everything done that it's up to date
- before releasing new version:
+ create new topics in manual for new features
+ change every screenshot that it matches current version
+ change every text that it matches current version
+ update translations

Pretty hard job  8)
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: szebenyib on July 02, 2014, 15:46:34
- will try to find native English speaker (finally) to create perfect English translation (also for Locus itself)
 - will try to find native German speaker to create perfect German translation.
8-) 8-)
I believe that is an excellent idea, I have seen people to express their concern about it, so this should help a lot!!
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: Christian on July 02, 2014, 20:23:37
@berkley, you got it. This is the usual way to go if something has changed.
I offered translation into german language to menion.
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: berkley on July 02, 2014, 22:02:28
@Christian
Unfortunatly I think I won't find the time to do this in full time. But if you need some help, I'm sure I find a few hours to support you.
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: Christian on July 04, 2014, 09:26:49
You are welcome.
Title: Re: Discussion about Locus manual (Dokuwiki)
Post by: menion on April 29, 2015, 21:24:15
New manual is not published. Well, new manual "work in progress", so this quite old discussion may be closed once forever :).


new thread -> http://forum.locusmap.eu/index.php?topic=4558.0;topicseen#msg36552