Re: [gpsd-users] gpsd systemd troubleshooting: Draft

[Gary E. Miller]

Yo Charles!

On Fri, 4 Oct 2019 16:12:35 -0600
Charles Curley <address@hidden> wrote:

> Attached is a diff against www/troubleshooting.html with proposed new
> systemd material in it. I produced it with

A good start, but needs work.

The order of the new material is loopy.  First it talks about the config
files that systemd(ung) uses, then talks about installing gpsd with
apt, which would install the files that the first part expected to be
present.

A simple time line from start to finish is preferred.  Not one that jumos
from after installed, back to installing, and then...

A troubleshooting document needs to be very time linear, with lots of
checkpoints for sanity checking.

And, no need to talk about the installation in the troubleshooting doc.
The installation details go in the INSTALL file, just point to them.

The doc also assumes a user has installed with "apt", which is not present
on many systemd(ick) systems.  The troubleshooting needs to support
whatever method, from the INSTALL file, that the system is in.  Possibly
a mess of distro and self-installed gpsd.

The doc assumes the user is usuing a hot-pluggable GNSS receiver.  The
majority case case of users with problems is Raspberry Pi users that
do not have hot-pluggable receivers.

I'll leave it to others to verify the systemd(umber) details in the doc.

RGDS
GARY
---------------------------------------------------------------------------
Gary E. Miller Rellim 109 NW Wilmington Ave., Suite E, Bend, OR 97703
        address@hidden  Tel:+1 541 382 8588

            Veritas liberabit vos. -- Quid est veritas?
    "If you can't measure it, you can't improve it." - Lord Kelvin

pgpZGGtEvNcmS.pgp
Description: OpenPGP digital signature