Seeing that Uncle Bob is making a new version of Clean Code I decided to try and find this article about the original.

  • @[email protected]
    link
    fedilink
    21
    edit-2
    3 months ago

    Tells me all I need to know about what the method does

    No, it only tells you what the method is supposed to do.

    While that may be helpful it may also be misleading. It helps just as much as comments when debugging - and that probably is the most relevant reason for trying to figure out someone else’s code.

    • @[email protected]
      link
      fedilink
      English
      14
      edit-2
      3 months ago

      It also tells you nothing about the data flow or the data at all. What do these functions do? What data to they act on? It is all just pure side effects and they could be doing anything at all. That is far from what I consider clean.

      “Show me your flowchart and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won’t usually need your flowchart; it’ll be obvious.” – Fred Brooks, The Mythical Man Month (1975)