[TUHS] Another "craft" discussion topic - mindless tool proliferation

Peter Jeremy peter at rulingia.com
Wed Sep 20 16:43:17 AEST 2017


On 2017-Sep-19 18:09:27 -0700, Lyndon Nerenberg <lyndon at orthanc.ca> wrote:
>*Please* write your documentation in a way that allows you to generate
>(useful, readable!) PDF documents that I can download for offline viewing.
>Believe it or not, I don't haul along a 300 mile cat-5 cable when I go
>sailing.  I still like to write code on the boat.  So much for Go :-P

One of the really nice things about Go is that all the library source code
and documentatin is installed by default and you can run a local instance of
the documentation server on your laptop (or whatever).  Likewise, the
specification is one HTML page - if you really want, you could convert that
to PDF but having all the hyperlinks is really handy.  (I haven't tried
running a local copy of the playground but that should be possible as well).

-- 
Peter Jeremy
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 949 bytes
Desc: not available
URL: <http://minnie.tuhs.org/pipermail/tuhs/attachments/20170920/e23727ef/attachment.sig>


More information about the TUHS mailing list