3 ms·
> Are Javadocs still a thing? When I was young and coded Java the last time that was all fancy and normal to do. But today? Automated API documentation based
by creatonez 3y ago
> Are Javadocs still a thing? When I was young and coded Java the last time that was all fancy and normal to do. But today?
Automated API documentation based on code comments never really died, but the popularity of dynamically typed programming languages had a lot of devs writing API docs separately by hand for a while. Even though some dynamically typed languages had tools for it, they were ignored because nobody had reliable IDE integrations for Javascript/Python, and maybe (?) because of a sentiment that it is a weird enterprise thing to do. Many open source projects adopted casually-written documentation more focused on usage examples, skipping out on detailed documentation of procedures that are deemed too obvious to need docs.
But nowadays we are in a golden age of doc generator tools across various languages.