[lproven]

> And so it drives me crazy to see the state of their documentation.

I talked about this in my article about the release:

https://www.theregister.com/2025/05/09/new_lazarus_4/

[CaptainOfCoit]

The only relevant part I can find from that article is:

> One criticism we've seen of the FreePascal project in general concerns its documentation, although there is quite a lot of it: eight FPC manuals, and lengthy Lazarus docs in multiple languages. There is a paid-for tutorial e-book available, too.

The criticism is that there is too much documentation available? And they're long, and dare even to be available in multiple languages?

[lproven]

No. You are incorrectly chaining statements.

* Many criticise the docs; * There _are_ docs, and a lot of them.

This is not an "A therefore B" proposition.

It is offering 2 points, not positing a connection:

"The docs are not very good." AND "Docs do exist, lots of them."

In other words: there are docs, lots and lots of docs, but they are not very good.

For instance, specifically, the indexing and cross-referencing is, I am told, poor.

Too much documentation, if badly organised, can be as bad as too little.

[CaptainOfCoit]

I'm incorrectly asking questions? You sound like a great author.

I was asking about why the documentation was bad, with one example. You could reply "No" but instead shared some word-salad?

You could have just replied "Someone told me the indexing and cross-referencing is poor, I agree/disagree with that because of X" so we could have a normal human conversation instead of you trying to lecture some random internet commentator on completely irrelevant logic. Just be human instead.

[sigzero]

He did not say you are incorrectly asking anything. He said you were reading it wrong and explained why.

[lproven]

Thank you!

I sometimes wonder what more I could do to be clear. :-(