0

I'm critiquing code that runs perfectly, but which is difficult for people to read, understand, and interpret.

Code which is pleasant to read and is relatively easy for people to interpret is often deemed 'expressive', in that it conveys the ideas to humans well.

What is the right way to describe something (code, or technical writing, or anything else really) that is not incorrect in any way, but which fails to easily communicate with at least one part of its intended audience?

I've considered:

  • expressionless
  • inexpressive

I wonder if there are other words (or perhaps phrases) that can describe the property of being technically correct, but not easily understood or interpreted?

7
  • 3
    Maybe obscure.
    – Xanne
    Commented Mar 28, 2021 at 2:09
  • 1
    How about arcane?
    – Hot Licks
    Commented Mar 28, 2021 at 2:47
  • 2
    And there's obtuse.
    – Hot Licks
    Commented Mar 28, 2021 at 2:48
  • 3
    @KannE - Yeah, "spaghetti code" is commonly used to describe a particular style of coding, with lots of GOTOs, suggesting that the code was not well thought out.
    – Hot Licks
    Commented Mar 28, 2021 at 11:51
  • 2
    We often call this Write Only code.
    – Jim
    Commented Mar 28, 2021 at 20:48

4 Answers 4

1

As a programmer, the word that I would use to describe such code or technical documentation is unclear

  • not expressed in precise terms

  • difficult to understand

Your suggestion of inexpressive will also be understood, though that phrase is used less often in this context. The word expressionless, however, is definitely incorrect; it means "lacking in facial expression", or "not expressing any emotion", neither of which means the opposite of expressive code or documentation.

Note that there is a very specific word used for code that is intentionally unclear, which is obfuscated. This word is used quite a lot, but doesn't apply when the code is unclear simply because it was poorly written.

1
  • I am not happy criticising an accepted answer and am usually loth to do so but on this occasion I feel it incomplete, so please consider my own suggestion below.
    – Anton
    Commented Mar 28, 2021 at 7:21
1

Whilst we call computer code, 'languages' and they have a 'grammar' and a 'syntax', they aren't really languages.

Moreover, as a programmer, I've never come across code that actually is 'expressive' in the sense that actually existing living language are and given what I've said above, nor should we expect them to be.

They are 'clear' or 'obscure' to the small community that code for a living or as a hobby in terms of what that code is setting out to achieve and this will depend on ancillary stuff like in-code commenting, a descriptive naming strategy for functions, variables and the like as well as technical documentation and even access to the original programming team - depending upon the complexity of the code. It will also depend also on the underlying language itself - who now wants to read assembly code, or worse, machine code in hexadecimal?

1

How about murky?

Not clearly known, understood, or expressed:

murky writing

[American Heritage Dictionary]

0

Unclear may apply to incorrect ideas. Indeed, ideas unclearly expressed tend to be incorrect, whereas those clearly expressed tend to correctness.

If you want a word that hints better at the correctness of ideas while also describing their inaccessibility, try abstruse.

abstruse adjective

difficult to comprehend : RECONDITE

”the abstruse calculations of mathematicians”

”abstruse concepts/ideas/theories”

Merriam Webster’s examples and its reference to Recondite seem to refer to things that are correct but difficult to understand.

Recondite = not known about by many people and difficult to understand

Cambridge

1
  • 1
    I don't think either of the two suggestions— recondite or abstruse — fits the bill because these two words apply to something that is intrinsically difficult, and it's by this very property of being difficult that the topic/concept is inaccessible to others. The OP, in my opinion, is looking for a word that has more to do with the inability of someone to put across their point well.
    – user405662
    Commented Mar 28, 2021 at 8:59

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .