Comment by lproven
1 month ago
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.
He did not say you are incorrectly asking anything. He said you were reading it wrong and explained why.
Thank you!
I sometimes wonder what more I could do to be clear. :-(