[Info-vax] Online and offline VMS documentation in HTML format

[Stephen Hoffman]

On 2021-10-02 16:42:33 +0000, Simon Clubley said:

> Does anyone else think it would be useful for VSI to supply and host 
> HTML versions of the documentation so that you could point someone 
> directly to a section of the manual without them having to download the 
> whole manual or having to read an older version of the documentation 
> online at a third party site ?

There are many larger issues around information design at VSI, HTML 
being one of many details involved.

I'd rather have updated doc in those PDFs, and examples and cookbooks, for now.

Further along and closer toward V9.3 or so, and particularly as part of 
work toward better a better information design for VSI itself and its 
documentation, sure.

Oh and BTW, you can specify a PDF page in a PDF in a hyperlink in many 
tools. For example:

https://vmssoftware.com/docs/VSI_USERS_MANUAL.pdf#page=23

The PDF-generation tooling that VSI uses here could (preferably) make 
that page numbering match reality and not contend with the archaic 
DEC-style page numbering scheme, or (less preferably, and somewhat less 
inconveniently) could make the page number in the generated PDF itself 
into a hyperlink, but here we are.




-- 
Pure Personal Opinion | HoffmanLabs LLC