Skip to content
DevMeme
6844 of 7435
Self-Documenting Code Taken to Absurd Extremes with Function Name as Comment
CodeQuality Post #7503, on Dec 2, 2025 in TG

Self-Documenting Code Taken to Absurd Extremes with Function Name as Comment

Description

A meme with large bold text at the top reading 'when you love writing code but you hate writing comments' followed by a dark code editor screenshot showing a Python function definition with an absurdly long name: 'def You_Can_Call_Your_Functions_Really_Long_Names_if_You_Want_To_Now_Because_Python_Does_Not_Enforce_Length_Limits_On_Function_Names_and_also_Classes_Either_plus_its_easy_to_type_because_text_editors_these_days_have_a_feature_called_autocomplete_so_you_can_just_type_the_first_letters_of_the_name_and_then_press_down_once_or_twice_and_hit_tab():'. The function name itself IS the documentation, taken to a comically extreme level. The code uses Python's def keyword with snake_case naming

Comments

18
Anonymous ★ Top Pick This is what happens when someone takes 'code should be self-documenting' literally and the code gets a restraining order
  1. Anonymous ★ Top Pick

    This is what happens when someone takes 'code should be self-documenting' literally and the code gets a restraining order

  2. @AmindaEU 7mo

    *is just pondering running off walls while screaming about a project having no documentation and how would anyone get anything done if key person just died*

    1. @AmindaEU 7mo

      if I died, everything I have ever touched would probably die with me, since no one ever reads the documentation I write or claims to have been unaware of it

      1. @AmindaEU 7mo

        am I hangry? Maybe I should try eating in addition to overdosing coffee in case it would help either headache or anger

    2. @Artkash 7mo

      Clearly, the function's name makes it self-explanatory, containing all possible intricacies it has. If you need documentation for your code to be understood, you just didn't use enough functions or named them inappropriately! /sarcasm

      1. @azizhakberdiev 7mo

        technically doc comments are just for ide code suggestions to work /s

        1. @azizhakberdiev 7mo

          (to be fair I'm more motivated to write doc just for this than anything else)

  3. @deerspangle 7mo

    PEP8 line length limit would like to know your location

  4. @Daonifur 7mo

    Me whenever the job pays by lines of code or letters/words added rather than some other useful metric

  5. @ulanov_show 7mo

    lgtm

  6. @Artkash 7mo

    All my functions' names are: * Starting with a letter * Containing at least 8 characters * Containing at least 1 uppercase letter * Containing at least 1 digit * Containing at least 1 full English sentence with correct grammar and punctuation

    1. @Broken_Cloud_1 7mo

      My function names are signatures🤓☝️

  7. @sysoevyarik 7mo

    hehehe

    1. Deleted Account 7mo

      wtf?

      1. @sysoevyarik 7mo

        just some function/variable names from metal/vulkan/opengl (metal one is probably just crappy generated bindings but still cursed)

        1. Deleted Account 7mo

          yes exact my naming variables in my cpp codes :D

  8. @NaNmber 7mo

    srp fears him

  9. @FunnyGuyU 7mo

    Just force developers to maintain their code. Indefinitely. Till death.

Use J and K for navigation