Hi Michael > Well, I have mixed feelings with wikis. I agree that their content can > be useful, but they need constant attention by the maintainers to stay > up to date. > > Moreover I would feel more inclined to compose some docs, if they would > be shipped with qlandkarte. Right now the 'help' menu is pretty much > empty. Having a real manual would be much nicer than a wiki (needless to > mention the advantages: offline readable, translatable, bound to the > sources, and hence within the attention focus of the developers, ...).
Sure internal docs would be fantastic. But either way, wiki or internal docs, the stuff has to be written. And currently the problem is more the lack of content than the availability of documentation systems. > > A manual doesn't have to be a huge book. I do most development in the > python world where sphinx [0] has taken documentation to the next level. > Having a similar thing for qlandkarte would be awesome. Using the > restructured text format (which is very similar to wiki markup) would > also significantly lower the contribution threshold (e.g. in comparison > to Latex, docbook, or other available formats). > I am pretty open to everything on this topic. Would it be possible for you to add what ever it needs to QLandkarte source tree. Including a 1st article as example (e.g. How to handle SRTM data). If there is anything to do on the C++/QT side just tell me what to do. If that leads to an internal database that is easily to edit and append for users we can call it a big step forward as probably more users are willing to contribute articles. At least that happened to translation. After Marc established the translation system, QLandkarte GT supported 3 other languages in about 6 weeks. If you need to contact me quickly you find me most of the day in IRC #qlandkarte (freenode) Oliver
signature.asc
Description: This is a digitally signed message part.
------------------------------------------------------------------------------ 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
_______________________________________________ QLandkarte-users mailing list QLandkarte-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/qlandkarte-users
