20 Sep
2017
20 Sep
'17
12:43 p.m.
On 2017-Sep-19 18:09:27 -0700, Lyndon Nerenberg <lyndon(a)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