On 2026-09-09 12:47, Michael Van Canneyt via fpc-pascal wrote:
Hi Michael,
In an effort to improve the readability of the online docs, I've
instructed Claude to create various CSS styles for the documentation.
You can view the 3 which I retained here:
https://www.freepascal.org/~michael/docs-demo/docs/
I'd like to sollicit some feedback on which is considered the most
readable of the
three: book, compact or modern.
.
.
Obviously, it's matter of subjective preferences. Personally, I prefer
the compact version except for the square buttons at the top and bottom
of the content pages - those links look better in both the other styles
(i.e. with rounded edge or no edge at all). What I especially _dislike_
about the book style is that the references to specific constructs
aren't so easily distinguished from the surrounding text - see e.g. the
"MyType" type name at the bottom of
https://www.freepascal.org/~michael/docs-demo/docs/book/ref/refsu108.html#x251-27700016.6.4
(brown compared to black text around it) versus the same on
https://www.freepascal.org/~michael/docs-demo/docs/compact/ref/refsu108.html#x251-27700016.6.4
or
https://www.freepascal.org/~michael/docs-demo/docs/modern/ref/refsu108.html#x251-27700016.6.4.
Just my 2 cents
Tomas
_______________________________________________
fpc-pascal maillist - [email protected]
https://lists.freepascal.org/cgi-bin/mailman/listinfo/fpc-pascal
