Re: upcoming pretest release

[Per Bothner]

On 2/16/21 1:40 PM, Gavin Smith wrote:
> I'm getting very close to building and uploading a pretest release,
> although I am sure that there is still more to be done.  Please think
> if there is anything that desparately needs to be done (i.e. stuff that
> is clearly broken), avoiding large changes if possible.

Great.  I'd considering changing the DomTerm home page from one
generated by 'makeinfo --docbook ... && xlts ...docbook-stylesheets'
to one generated by 'makeinfo --html ...info.js ...'
I prefer to do that based on an actual release!

Comparing before-and-after, it's looking pretty good.
Old: https://domterm.org/
New: https://per.bothner.com/tmp/DomTerm-txjs
(The latter contains some draft contents changes, too.)

Here are some differences/blemishes I noticed.

* Awkward sub-page link header - see email "footer navigation headers"
For example: http://per.bothner.com/tmp/DomTerm-txjs/Wire-byte-protocol.html
(Move/tweak page-end link; hide internal headers with css.)
[This is the main issue I'm hoping you or Patrice can look into.]

* js-info sidebar shows too many entries (in my opinion).
Compare https://per.bothner.com/tmp/DomTerm-txjs/Tips-and-solutions.html
with https://domterm.org/Tips-and-solutions.html
[This requires changes to info.js which I can probably handle.]

* Related: Boldface or other emphasis in the sidebar for the current page
is I think helpful.

* Hide "Script license information" link or move it to "Help" page.
It's clutter that I don't want on my website, though I might be
ok with it in the help page.

* Problems with links to files in the current "directory".
For example, try clicking on the first image on the home page.
[This is another js-info issue I can look into.]

* Fix [Function:] in synopsis to remove colon.
See http://per.bothner.com/tmp/DomTerm-txjs/The-DomTerm-JavaScript-class.html
[This can probably be done with a DomTerm-specific JavaScript hook.]

* Make sure page URLs are compatible.  Specifically,
fix node or anchor names containing hyphens.
For example: http://per.bothner.com/tmp/DomTerm-txjs/electron_002dnodepty.html

* The sidebar shows an extra level of indentation.

* Minor styling differences that can probably be easily fixed with css.
--
        --Per Bothner
per@bothner.com   http://per.bothner.com/