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
Use J and K for navigation
Comments
18Comment deleted
This is what happens when someone takes 'code should be self-documenting' literally and the code gets a restraining order
*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* Comment deleted
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 Comment deleted
am I hangry? Maybe I should try eating in addition to overdosing coffee in case it would help either headache or anger Comment deleted
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 Comment deleted
technically doc comments are just for ide code suggestions to work /s Comment deleted
(to be fair I'm more motivated to write doc just for this than anything else) Comment deleted
PEP8 line length limit would like to know your location Comment deleted
Me whenever the job pays by lines of code or letters/words added rather than some other useful metric Comment deleted
lgtm Comment deleted
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 Comment deleted
My function names are signatures🤓☝️ Comment deleted
hehehe Comment deleted
wtf? Comment deleted
just some function/variable names from metal/vulkan/opengl (metal one is probably just crappy generated bindings but still cursed) Comment deleted
yes exact my naming variables in my cpp codes :D Comment deleted
srp fears him Comment deleted
Just force developers to maintain their code. Indefinitely. Till death. Comment deleted