Hi, Although one of Viking's strengths is the ability to use it offline, you need to be online to download the maps in the first place. It follows that most of the research as to how to use it etc. will be when there is an internet connection.
As Viking is still evolving it makes sense to have a system that is easy to update, and the Wiki appears to fit this description. I agree with your comments about two systems if copying one to the other is not easy & will involve manual changes each time. My experiences of duplicate systems is that they invariably end up with variations that can be confusing. When I am going away to somewhere without internet connection I often copy webpages to my laptop so I can access them whilst away - how about a brief offline document that provides a link to the online wiki, but suggests the user may wish to copy the wiki pages to their computer if they anticipate using without an internet connection? Nick On Sun, 2009-09-27 at 18:14 +0200, Guilhem Bonnefille wrote: > Hi, > > I started to add help documentation in viking. You can browse/test my work at > http://repo.or.cz/w/viking/guyou.git?a=shortlog;h=refs/heads/help > > Currently, the documentation is written as DocBook because Gnome > provides tools to manage it. > In order to fill the documentation, I partly converted the "User > Manual" page of the wiki via > http://toolserver.org/~magnus/wiki2xml/w2x.php > The result is far from perfect. Many hand rewrite must be done. Some > of them due to w2x tool, others due to wiki page malformed content. > But this is currently a proof-of-concept. > > > IMHO, it will be definitively impossible to maintain TWO versions of > the user manual. I can imagine two processes: > - keep the User Manual on the wiki and regularly (just before > releasing) convert the content to update the help documentation ; > - remove the wiki page, maintain only the DocBook version, and provide > a HTML version on the viking's site (converted via official DocBook's > XSL stylesheets). > > What is YOUR opinion? > As it directly concern contributors involved in the documentation, > this is YOUR decision. > Do you prefer DocBook or MediaWiki? > I really need to know your opinion. > ------------------------------------------------------------------------------ Come build with us! The BlackBerry® Developer Conference in SF, CA is the only developer event you need to attend this year. Jumpstart your developing skills, take BlackBerry mobile applications to market and stay ahead of the curve. Join us from November 9-12, 2009. Register now! http://p.sf.net/sfu/devconf _______________________________________________ Viking-devel mailing list Viking-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/viking-devel Viking home page: http://viking.sf.net/
