undefined | Better HN

0 pointsCaptainOfCoit1y ago0 comments

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?

0 comments

3 comments · 1 top-level

lproven1y ago· 2 in thread

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.

CaptainOfCoitOP1y ago

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.

sigzero1y ago

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

1 more reply

j / k navigate · click thread line to collapse