Ask HN: Which programming language has the best documentation?

#1

Post by siquick » Tue, Jan 23, 2018, 11:41 PM UTC

No post body was provided.

Re: Ask HN: Which programming language has the best documentation?

#2

Post by cag_ii » Tue, Jan 23, 2018, 11:49 PM UTC

I would have to say Java. Between the tutorials, Language/VM specification & library Javadocs, it's the most thorough I've seen to date...

Re: Ask HN: Which programming language has the best documentation?

#3

Post by tonteldoos » Tue, Jan 23, 2018, 11:58 PM UTC

Do you mean formal documentation, or all documentation (including sources like stackoverflow, blog posts, etc)?

I haven't used Java in a while, but my experience lately with Python docs (both formal and informal) has been fantastic. This applies not just to the core language and libraries, but also various third party libraries and frameworks.

Re: Ask HN: Which programming language has the best documentation?

#4

Post by westurner » Wed, Jan 24, 2018, 1:36 AM UTC

Python! The Python docs are written in ReStructuredText and built with Sphinx.

https://docs.python.org/

https://devguide.python.org

https://packaging.python.org

Re: Ask HN: Which programming language has the best documentation?

#5

Post by yanshuai » Wed, Jan 24, 2018, 3:19 AM UTC

C# does!

Re: Ask HN: Which programming language has the best documentation?

#6

Post by megaman22 » Wed, Jan 24, 2018, 3:23 AM UTC

yanshuai wrote: post #5

C# does!

Core stuff, sure. But much of MSDN is a wasteland of autogenerated garbage and super vague shit that is of no use to anyone.