[Expo-tech] unless Phil shows me that it's already there

[Wookey]

On 2019-07-29 16:59 +0100, Philip Sargent (Gmail) wrote:
> Nothing quite so succinct is in the handbook - but the intended audience is
> different.
> 
> Nat & Becka are good examples of people who want to do the cave-surveying
> nerding but not the programmer nerding.

Everyone who needs to add survey data or drawings or cave info, on a
computer that has not been pre-prepared for them (i.e their own
laptop), needs this info.
 
> This is a big gap in the handbook.
> 
>  
> 
> ·         I have been concentrating on the numpty guides for uploading photos,
> gpslogs, and downloading gps tracks and waypoints.

Which is good.
 
> ·         I have also been playing catch-up in the expert-nerding pages on how
> to edit the handbook and use rsync, scp, sftp and whatnot because Tom and
> Radost need that otherwise they tend to just guess and hope (which has gone OK
> so far..). see http://expo.survex.com/handbook/manual.html#usernamepassword and
> http://expo.survex.com/handbook/computing/keyexchange.html
 
Good. Why point people at info for multiple ssh keys? Who really needs
more than one key per machine?

> But the most important bit is the bit in the middle!
> 
> which is http://expo.survex.com/handbook/caveentry.html and is mostly full of
> “TO DO” paragraphs

Yeah. Well, if we don't have to move the server again or spend all our
time fixing the system we might actually get some cave data updated
this year, and then be able to document the process :-)
 
> Clearly that manual.html page needs to be expanded hugely and split up into the
> 2 types of nerd: carve-nerd and programmer-nerd.
> 
> Or are there more types ?

There are windows-users, phone users, mac users and linux users. It's
hard to write comprehensible docs that cater for all as soon as
installing/setting-up software is involved. At the cave-nerd level
doing at least the set-up docs per-OS makes a lot of
sense. Programmer-level nerds can usually work out which bits apply to
them.

Wookey
-- 
Principal hats:  Linaro, Debian, Wookware, ARM
http://wookware.org/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.wookware.org/pipermail/expo-tech/attachments/20190729/61c3459e/attachment.sig>