[fpc-pascal] Docs style update

Tomas Hajny XHajT03 at hajny.biz
Wed Sep 9 13:46:14 CEST 2026


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


More information about the fpc-pascal mailing list