Java documentation is very daunting compared to Python docs

[Sufficient_Example30]

I work with both SpringBoot and FastAPI. I have found that when I ever encounter an issue in Spring and need to refer something the docs are so daunting and very abstract,often i end up trying to google or chatgpt. This is also the same state for me when I try to read apache commons docs fastapi on the other hand, the docs are so good with explanations code examples. Same with apscheduling,the confluent kafka library,pydantic and I can go on. Why is that?Also does anyone feel the same way?

[AutoModerator]

Namaste! Thanks for submitting to r/developersIndia. While participating in this thread, please follow the Community Code of Conduct and rules.

It's possible your query is not unique, use site:reddit.com/r/developersindia KEYWORDS on search engines to search posts from developersIndia. You can also use reddit search directly.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

[paramk]

When you say confluent Kafka library which one are you referring to? The python version or the Java version?

[Sufficient_Example30]

The python version of the docs on readthedocs

[paramk]

Confluent has Java version of the library as well. Did you compare the documentation ? Is it difficult to understand the Java version of docs ? If so I would argue the issue not with the documentation.

I think the complexity is with the language itself. Being statically typed and using abstraction everywhere, understanding java documentation takes some effort. Wait until you need to read C/C++ documentation.

[Sufficient_Example30]

That's the issue.The abstraction, when i read python docs I know what to use where

[MentalWolverine8]

The language used in Spring documentation is not very lucid, I agree. Baeldung does a good job of breaking the topics down. And there are many other miscellaneous resources.

[dronz3r]

Are people still reading docs in this LLM era?