Which is more important to you in a language, feature richness or documentation quality?

a year ago by Sunsofold to c/programming

After seeing this post I just thought it would be an interesting discussion. Obvious limits apply of 'you have to have at least some documentation,' so I'm not talking about something where there is none, and the feature set minimum would be less a question of whether you could complete X arbitrary project and more 'does the feature set make it easy to do everything?' You could essentially write everything in assembly, but would you want to?

On an arbitrary 1-10 scale, (1 being 'I'll build the features from nothing as long as the docs are good' and 10 being 'Who needs documentation? I'll happily read through the undocumented code until I find the ones that make magic happen.') where do your preferences lie?

Oh, and integers only. You can be nuanced in your ideas but no 5.5s allowed.

load all comments
MalditoBarbudo 4 points a year ago

3

If the documentation is good enough, I don't mind implementing the lacking features if needed. But I work in small codebases in R, which have good docs and is feature rich, so maybe I'm a little spoiled.

path: 0 19162687, hotness: undefined, score: 4, children: 0
programming
programming

@programming.dev

login for more options
28795
3717
3346

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev


go to feed...