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.

  • who@feddit.org
    link
    fedilink
    English
    arrow-up
    0
    ·
    edit-2
    4 days ago

    A feature without quality documentation is a feature I cannot rely upon. (Or if I wrote it, one that I cannot expect other people to use.)

    When faced with such things, I avoid them, and implement richer features myself using basic ones that are well documented.

    Related: https://en.wikipedia.org/wiki/Undocumented_feature