Helmut,

On Tuesday, 2016-03-15 22:34:09 +0100, you wrote:

> ...
> the Windows build description has never been part of the Wiki.
> It has always been in the source repository as the build instructions 
> may be version dependent.

If "version dependent" means "depending on the  Windows version" I would
like to point out  that the wiki already  contains version dependent in-
stallation instructions: Ubuntu 14.04.

Anyway, from a customer's perspective  I'd prefer to have _ALL_ the doc-
umentation in a single repository  I can clone locally.   For a customer
it's a bit  unsatisfactory  to find  three sources,  the two local files
"nsi/HOWTO-BUILD.txt", "nsi"/3rdparty.txt", and the document at

   https://bitbucket.org/maproom/qmapshack/raw/tip/nsi/HOWTO-BUILD.md

which -- at least at first glance -- are rather similar,  forcing one to
sift through  all three files in parallel  looking for differences.   If
you're lucky,  there are none  or the three files are supplementing each
other, but if you're  not that lucky,  you are  forced to  make educated
guesses as to which information to trust.

In both cases  you'd be way better off,  if someone who knows would have
merged these three files into a single file, put it in the wiki, and on-
ly provided a small file  "README.txt", "HOWTO.txt", or "INSTALL.txt" in
the "nsi/" directory of the source code repository  which basically con-
tains the URL of the file in the wiki.

And from a maintainer's  point of view I would, too,  prefer to have the
documentation in a single place where it's relatively easy to keep it up
to date and consistent.

Just my two cents worth ...

Sincerely,
  Rainer

------------------------------------------------------------------------------
Transform Data into Opportunity.
Accelerate data analysis in your applications with
Intel Data Analytics Acceleration Library.
Click to learn more.
http://pubads.g.doubleclick.net/gampad/clk?id=278785231&iu=/4140
_______________________________________________
Qlandkartegt-users mailing list
Qlandkartegt-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/qlandkartegt-users

Reply via email to