Erik Engheim
1 min readSep 9, 2021

--

Some good points, but I really think how young Julia is a the biggest factor. I have been programming in various languages for over 25 years now and I cannot remember young languages ever having great documentation.

In fact I think Julia has very good documentation given how young it is. The first good documentation I came across I remember was the Qt C++ library.

Objective-C and Cocoa had quite good conceptual documentation on things like design patterns, but reference documentation even today isn't particularly good.

I would say Go has very good documentation. Julia is just more of a mixed bag I think. The standard libraries and language itself is quite well documented in my opinion. Also some of the more popular packages are quite well documented.

With Julia the chief problem seems to be all the package where documentation is almost entirely lacking. Is Documenter too easy?

Nah, I find myself doing a better job documenting my Julia code than I ever did with other stuff.

But I agree that multiple dispatch creates its own challenges. Maybe we don't have a great solution to that yet. We are in uncharted territories.

In particular the need to explain how Julia packages can easily be comabined, need a better document strategy, or maybe just time.

--

--

Erik Engheim
Erik Engheim

Written by Erik Engheim

Geek dad, living in Oslo, Norway with passion for UX, Julia programming, science, teaching, reading and writing.

No responses yet