Swift's DocC has done so much for lifting the entire community.
It is the launchpad for a virtuous cycle to maximize the value of your code.
It seems almost obvious in retrospect, but I have spent decades struggling with this, and watched hundreds of projects flop in this last mile.
Kudos to whoever decided to fund this and see it through.
Give those guys a bonus and a promotion.
@Migueldeicaza I truly agree! Generating code documentation has always been a hassle to include in an open source project. Just the fact it’s been a third-party plugin or standalone software made it even more of an effort to use it.
Python is an exception here, but it’s a scripting language — not native by default (yes, I know about ways to compile Python 3 code down to machine via C++ code translation, but those are, again, third-party offers).
@Migueldeicaza Doxygen is a classic in C and C++ circles, but compared to DocC it’s not even close to being as intuitive. I’m sure there are IDE’s out there with excellent Doxygen support, but I haven’t seen it in the wild myself, out of the box.
I have a feeling that AI engines will be used to make documentation generation easier in the near future.
Miguel de Icaza ᯅ🍉
Arcticulate