Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Mailing lists / lazarus / 2026-09

Docs style update

8 messages · 8 people · –

Reply by email Subscribe to this list Your subscription

Read-only archive. Use j and k to move between messages.

Michael Van Canneyt

Hi,

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.

Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated)

Note that only CSS changes are involved, so no 'structural' changes.

Michael.

Reply by email

Sergey Bodrov
to Michael Van Canneyt

"book" looks like fiction, without navigation and very unserious font "compact" is perfect for side panel or smartphone
"modem" is just perfect

??, 9 ????. 2026??. ? 13:47, Michael Van Canneyt via lazarus <

Show quoted text 30 lines
: Hi, 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. Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated) Note that only CSS changes are involved, so no 'structural' changes. Michael. -- _______________________________________________ lazarus mailing list https://lists.lazarus-ide.org/listinfo/lazarus
*Bodrov Sergey* software development, IT consulting https://sites.google.com/site/serbod <http://www.serbod.com> *Phone (Belarus):* +375(25)794-21-58 *e-mail:* , -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20260909/8567a669/attachment.htm>

Reply by email

John Landmesser
to Sergey Bodrov

.. i like compact style ...

JohnML

Sergey Bodrov wrote 47 lines
"book" looks like fiction, without navigation and very unserious font "compact" is perfect for side panel or smartphone "modem" is just perfect ??, 9 ????. 2026??. ? 13:47, Michael Van Canneyt via lazarus : Hi, 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. Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated) Note that only CSS changes are involved, so no 'structural' changes. Michael. -- _______________________________________________ lazarus mailing list https://lists.lazarus-ide.org/listinfo/lazarus -- *Bodrov Sergey* software development, IT consulting https://sites.google.com/site/serbod <http://www.serbod.com> _Phone (Belarus):_?+375(25)794-21-58 _e-mail:_ ,

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20260909/826d621a/attachment.htm>

Reply by email

Arne Hanssen
to Sergey Bodrov: "book" looks like fiction, without navigation and very unserious font "compact" is…

I'd agree that "Modern" looks best.

Arne

Den 09.09.2026 13:26, skreiv Sergey Bodrov via lazarus:

Show quoted text 47 lines
"book" looks like fiction, without navigation and very unserious font "compact" is perfect for side panel or smartphone "modem" is just perfect ??, 9 ????. 2026??. ? 13:47, Michael Van Canneyt via lazarus : Hi, 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. Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated) Note that only CSS changes are involved, so no 'structural' changes. Michael. -- _______________________________________________ lazarus mailing list https://lists.lazarus-ide.org/listinfo/lazarus -- *Bodrov Sergey* software development, IT consulting https://sites.google.com/site/serbod <http://www.serbod.com> _Phone (Belarus):_?+375(25)794-21-58 _e-mail:_ ,
Best regards Arne H. -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20260909/1a98e8e4/attachment-0001.htm>

Reply by email

Aurimenes Silva
to Michael Van Canneyt: In an effort to improve the readability of the online docs, I've instructed Claude to…

I think "Modern" looks best for this purpose.

*Aurimenes Apol?nio*
/Desenvolvedor de Software/
+55 (81) 98625-1676

Michael Van Canneyt wrote 22 lines
Hi, 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. Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated) Note that only CSS changes are involved, so no 'structural' changes. Michael.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20260909/018b4473/attachment.htm>

Reply by email

Michael Thompson
to Michael Van Canneyt: In an effort to improve the readability of the online docs, I've instructed Claude to…

Nice work!

I prefer Compact.

Many thanks

Mike

On Wed, 9 Sept 2026 at 11:47, Michael Van Canneyt via lazarus <

Show quoted text 30 lines
wrote: Hi, 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. Note this concerns only the latex-style manuals, not the reference documentation - that is generated by another mechanism (which will also be updated) Note that only CSS changes are involved, so no 'structural' changes. Michael. -- _______________________________________________ lazarus mailing list https://lists.lazarus-ide.org/listinfo/lazarus

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lazarus-ide.org/pipermail/lazarus/attachments/20260909/0b108775/attachment.htm>

Reply by email

Kostas Michalopoulos
to Michael Van Canneyt: In an effort to improve the readability of the online docs, I've instructed Claude to…
Michael Van Canneyt wrote 10 lines
Hi, 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/

Not a fan of the book style, but modern and compact look good. One issue though - the space after words like "#IFNDEF" here:

https://www.freepascal.org/~michael/docs-demo/docs/switch/user/usersu20.html#x44-510005.2.4

...should be outside the span because right now it makes the word have colored space on the right side with the word that follows outside the span be tightly next to it and that looks ugly:

http://runtimeterror.com/pages/iv/images/854af83049616885768979f68c0a0fc0.png

Obviously this is a generator and not a CSS issue but it is something that the CSS does make very visible.

Kostas

Reply by email