User manual: final edits before V4.0

[Dirk Hohndel]

On Sat, 2013-12-14 at 00:05 +0200, Willem Ferguson wrote:
> > 1)
> > you undid my change to move Windows first, Mac OS second and Linux
> > third. This is simply done by size of our user base. More than 70% of
> > our users are on Windows. So we should list that platform first. The
> > Linux platform is a massive and major pain in the rear. It's impossible
> > to create binaries that run on several version of the OS, the different
> > DEs make things miserable - certainly not the 'preferred platform'.
> >
> > It's the platform that most of the developers use, but never confuse the
> > developers with the users of an application.
> Its an inconsistency in myself. Being an environmental specialist in 
> academia, I see big companies destroying our world around us. I see 
> everyone bowing in the service of big companies that dictate what we do 
> and how we do things. NOT all big companies, but many of them. Companies 
> that protect only their own interest and not those of the people who use 
> their products, especially outside of the first world, and clearly 
> reflected in the countries like Rwanda that I visited earlier this week. 
> The energy industry of this world is probably the best example, the next 
> in line are the big agro-business companies. To me, being small and 
> being transparent is beautiful.  HOWEVER, I prefer taking out my life 
> insurance with a big company that I can trust. I prefer purchasing 
> hardware technology of a company I can trust (I started my programming 
> career with an 8080). Given this incurable inconsistency, I have a 
> tendency to put the large manipulating companies at the end of my list.
> I do not wish to bore or lecture you, I wish you to understand why 
> habitually I would order things in a particular way. With you coming 
> from SUSE, I think my argument would somehow make sense to you, but my 
> inconsistencies need not reflect in the user-manual.

I used to work for S.u.S.E., err SuSE, err SUSE... Now I work for Intel.
Not sure what that says about me.

But frankly, the user manual is more about end users and their
perception than anything else. And the vast majority of divers out there
is not very computer savvy. So I want to make them feel comfortable.

[...]
> I agree with you.

[...]
> I agree with you.

Excellent. :-)

Thank you for all your work on the Documentation. This was a HUGE
contribution to getting ready for Subsurface 4.0

Very much appreciated

/D