Comment by lproven
1 month ago
> And so it drives me crazy to see the state of their documentation.
I talked about this in my article about the release:
1 month ago
> And so it drives me crazy to see the state of their documentation.
I talked about this in my article about the release:
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?
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.
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.
2 replies →