[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: upcoming pretest release

From: Per Bothner
Subject: Re: upcoming pretest release
Date: Tue, 16 Feb 2021 15:46:46 -0800
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.7.0

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/

reply via email to

[Prev in Thread] Current Thread [Next in Thread]