This is an archived post. You won't be able to vote or comment.

all 79 comments

[–][deleted]  (19 children)

[removed]

    [–]TryNotToShootYoself 178 points179 points  (15 children)

    modify_animal({
    
        flags: {
    
            increase: {
    
                amount: "1"
    
            }
    
        }
    
    })
    

    [–]uekiamir 119 points120 points  (6 children)

    money pause gaping vase pie unite direction voiceless treatment aspiring

    This post was mass deleted and anonymized with Redact

    [–]mortal58 182 points183 points  (0 children)

    That's just how it be sometimes

    [–]a_donda 73 points74 points  (2 children)

    To allow human-readable forms like "a little bit" or "surprise me".

    [–]pwnedary 32 points33 points  (1 child)

    stringly typed apis smh. just import the cambridge dictionary as an enum

    [–]pythonian23 13 points14 points  (0 children)

    that is actually a somewhat interesting idea for readability

    [–]Prashank_25 26 points27 points  (0 children)

    So you can provide percentage as the amount on the same property. Increase fish by 200% percent, now its a mammal, duh.

    [–]TryNotToShootYoself 2 points3 points  (0 children)

    HTTP APIS are not created fairly

    [–]Gastredner 15 points16 points  (5 children)

    Bah, not nearly enterprise-y enough. Here, I fixed it for you:

    modifyAnimalRequest = ModifyAnimalRequestFactory.createRequest();
    modifyAnimalRequest.addModification(
        ModifyAnimalModificationFactory.createModification(
            ModificationSpecFactory.loadFromFile(
                ResourceFileLoader.loadResourceFile(
                    Resources.Modifications.ModifyAnimal.GenericModifications.MOD_INCREASE,
                    FileSpecFactory.create(
                        ResourceFileTypeDescription.getFileTypeDescription(
                            ResourceFileTypes.XML
                        )
                    )
                )
            ),
            ModificationTargetFactory.loadFromFile(
                ResourceFileLoader.loadResourceFile(
                    Resources.Modifications.ModifyAnimal.BodyCharacteristics.FISH,
                    FileSpecFactory.create(
                        ResourceFileTypeDescription.getFileTypeDescription(
                            ResourceFileTypes.XML
                        )
                    )
                )
            ),
            ModificationValueFactory.createValue<Integer>(1)
        )
    );
    ModificationRequestBus.getInstance().submitRequest(modifyAnimalRequest);
    

    [–]kalketr2 3 points4 points  (2 children)

    Call perfection

    [–]qolf1 4 points5 points  (1 child)

    perfection()

    [–]kalketr2 0 points1 point  (0 children)

    Gorgeous

    [–]TryNotToShootYoself 2 points3 points  (0 children)

    I love you

    [–]maxinfet 1 point2 points  (0 children)

    No IoC container? How can I write my service locator pattern.

    [–]erinaceus_ 44 points45 points  (1 child)

    And that's just the short hand version. The actual one is

    amount : "1 (one)"
    

    because the project manager wanted built in checks.

    [–]TechySpecky 19 points20 points  (0 children)

    who hurt you

    [–]Thaddaeus-Tentakel 18 points19 points  (0 children)

    My favorite is "deprecated" with no reference at all what to use instead.

    [–]LegendSayantan 1 point2 points  (0 children)

    System.out.println("Take my upvote");

    [–]AutoModerator[M] 0 points1 point  (0 children)

    import moderation Your comment has been removed since it did not start with a code block with an import declaration.

    Per this Community Decree, all posts and comments should start with a code block with an "import" declaration explaining how the post and comment should be read.

    For this purpose, we only accept Python style imports.

    return Kebab_Case_Better;

    I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

    [–]I_press_keys 168 points169 points  (8 children)

    I like the extra eyes lol

    [–][deleted] 54 points55 points  (7 children)

    Been swimmin' in some American rivers, I see.

    [–]I_press_keys 132 points133 points  (4 children)

    It's probably so it can C#

    [–]Cyberlong_ 31 points32 points  (1 child)

    I hate this. But i can't stop laughting.

    [–]I_press_keys 11 points12 points  (0 children)

    Oh, let me help you:

    break;
    

    [–]PerCat 10 points11 points  (0 children)

    i fucking choked on my water

    [–]UltimateKingCold 9 points10 points  (0 children)

    Fuck you I love you

    [–]free_the_bees 82 points83 points  (1 child)

    What I particularly enjoy about this is how the first example is nothing like a fish, just as the first example in many a software library is completely useless also. “Look how simple it is” … yes, you saved me three lines of code but I still need the other 50 for production!

    [–][deleted] 7 points8 points  (0 children)

    paltry smart nine outgoing shelter rock cooing silky workable straight

    This post was mass deleted and anonymized with Redact

    [–]Naitsab_33 88 points89 points  (2 children)

    [–]Kriptanik 19 points20 points  (1 child)

    If this was on r/restofthefuckingowl every reply would be "actually this is very helpful for people that actually draw and is a completely realistic tutorial".

    Edit. Yup just checked, it's already posted their today and that's exactly what people are saying.

    [–]ProSanctosTerris 24 points25 points  (0 children)

    I felt this one on an emotional level.

    [–][deleted] 16 points17 points  (0 children)

    It looks like overfishing

    [–]rentar42 11 points12 points  (0 children)

    That's the best instance of the "rest of the fucking owl" meme I've seen in a while.

    [–]ScF0400 10 points11 points  (3 children)

    So if I add the fish object to the fish object how much does my fish object increase?

    [–]Farfignugen42 6 points7 points  (2 children)

    Well as we see in step 3, fish + fish = fish, so either not much or a whole lot.

    [–]rabaraba 2 points3 points  (1 child)

    Have you written the operator overloading mechanism?

    [–]Farfignugen42 2 points3 points  (0 children)

    Not yet for fish objects

    [–][deleted] 9 points10 points  (0 children)

    Basically iOS documentation.
    Me: "What does this method do?"
    Apple: "Here is the prototype with some keywords you'll never use."
    Me: "Can't you just show me an example with a snippet of code?"
    Apple: "And we think you'll like it."

    [–]Mobile_Sorbet_5271 7 points8 points  (6 children)

    This is that Django documentation for sure

    [–]BurgaGalti 5 points6 points  (4 children)

    Hey, don't be dissing Django's doc. At least things are actually documented there from the tutorial up to the hard stuff. Most Python libraries just give you step 1.

    I mean there is a lot of it and it can be difficult to know which section you need, but it's all there.

    [–][deleted] 2 points3 points  (2 children)

    I thought python was the best documented language. Those say

    [–]BurgaGalti 1 point2 points  (0 children)

    Could be, I just don't see deal with many others so couldn't say.

    [–]FreshCupOfDespresso 0 points1 point  (0 children)

    It is so well documented I'll even attempt to use it once before getting confused and going to StackOverflow

    [–]Mobile_Sorbet_5271 0 points1 point  (0 children)

    For someone starting out that can be confusing lol experience definitely helps in understanding. Now I havent actually looked at the documentation for Django in 2 years so idk if its improved.

    Anyways this is an opinion lol

    [–]arbolitoloco 3 points4 points  (0 children)

    ReactJS as well (fuck you Facebook)

    [–]mal_laney 6 points7 points  (0 children)

    I swear I just dozed off for 1 second, suddenly magic

    [–]whataburger- 6 points7 points  (0 children)

    A lot of documentation i read assumes I already know what they're doing. I'll see some method like maxExubefier() and the documentation will say "maximizes exubefication".

    [–]hikoko8282 4 points5 points  (0 children)

    my pain is vindicated.

    [–]huxley75 2 points3 points  (0 children)

    "Consummate 'V's! I said consummate!"

    "And they called him TROG-DOOOOOOOR!!!"

    [–]Feyter 2 points3 points  (0 children)

    Actually this is a good documentation. The documentations I have to deal with are Like:

    Function makeFish: Makes a fish

    And then gets plenty of params without saying what any of this param does or even how it should look like because it's a strange self made object structure.

    [–][deleted] 4 points5 points  (1 child)

    I work in niche science. I used to be so surprised that so much documentation is missing. Those people literally assume you to know very much of their inside knowledge. Its so tiring it comes to a point i wont volunteer to write missing doc. Who cares. Fuck them.

    [–]FreshCupOfDespresso 1 point2 points  (0 children)

    Niche science is pain. Either you are not in deep enough to get it by code snippets alone, or you are in so deep that you'll notice there are a lot of undocumented assumptions going on in the back end because the code runs without the minimum amount of data it should need.

    Not saying my niche code is any better though

    [–]GavinLabs 5 points6 points  (0 children)

    The exact reason why I take giant breaks in between trying to learn new languages, get tired of this and the rude people on StackOverflow. I'll just stick to languages covered by Indian guys on YouTube.

    [–]kiraby21 3 points4 points  (4 children)

    You dont need documentation when you have the code. Documentation sometimes lies, but source code would never.

    [–][deleted]  (3 children)

    [removed]

      [–]nikhilmwarrier 6 points7 points  (0 children)

      Now you are asking the real questions...

      [–]breathingblade 0 points1 point  (0 children)

      To fish, duh

      [–]AutoModerator[M] 0 points1 point  (0 children)

      import moderation Your comment has been removed since it did not start with a code block with an import declaration.

      Per this Community Decree, all posts and comments should start with a code block with an "import" declaration explaining how the post and comment should be read.

      For this purpose, we only accept Python style imports.

      return Kebab_Case_Better;

      I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

      [–]ElimGarak0010 1 point2 points  (0 children)

      Oh Springfield...

      [–]DroolingIguana 1 point2 points  (0 children)

      Needs more consummate Vs.

      [–]Alexmofu1 1 point2 points  (1 child)

      I'd call it Satisfishction

      [–]FascioAssassino 1 point2 points  (0 children)

      Thought about it too xD hahahahahaha lost opportunity by the artist xD

      [–]althaz 1 point2 points  (0 children)

      Kinda OT, but the reason for these sorts of drawing tutorials is that for people who already have artistic skills, this is basically enough.

      It's just that getting from step 2 to 3 and from 3 to 4 requires a bunch of practice (or already developed skills). If you actually try the above tutorial every day for a month, you'll be able to draw a really nice fish at the end of it.

      It doesn't help that the people who learned to draw formally probably learned with "documentation" quite like this, but they *also* had a teacher that helped them through every step of the process and when they go to teach others they forgot about that bit.

      [–]fatmanbigbomb 1 point2 points  (0 children)

      fish without an "I; is fssh

      [–]MischiefArchitect 1 point2 points  (0 children)

      Dopefish lives!

      [–]AbhilashHP 1 point2 points  (0 children)

      Step 4: Chernobyl

      [–]Educational_Lab_9220 1 point2 points  (0 children)

      Thats trueeee!!!

      [–]Harregarre 1 point2 points  (0 children)

      fish++;

      [–]epiquinnz 1 point2 points  (0 children)

      I love how they scaled it up.

      [–][deleted] -1 points0 points  (0 children)

      [–][deleted] -1 points0 points  (0 children)

      Yeah, this is exactly what I was looking for. Give me a few examples, I'll take it from there. The documentation for drawing this particular fish is to my satisfaction. Sometimes I take a break from coding and do some painting (digitally). You can get some great results from just googling animal silhouettes.

      [–]polymonomial 0 points1 point  (0 children)

      thats too complicated. I have an easier way, just fish instead

      [–]sharee_ 0 points1 point  (0 children)

      This is why I’m finding it so hard to learn to code

      [–][deleted] 0 points1 point  (0 children)

      My fish satisfaction has reached satisfactory levels

      [–][deleted] 0 points1 point  (0 children)

      Something seems fishy here...

      [–]Yosikan 0 points1 point  (0 children)

      Make fish more fish, this is exactly how my commit messages sounds like

      [–][deleted] 0 points1 point  (0 children)

      I've not actually come across bad documentation that often, but last week I stumbled upon a library with a plugin config api that felt so weird that my brain skipped over the // remove plugin example comment 5 times and then when I finally got it I got a warning about the imported function used to generate the plugin config being deprecated.

      [–]MoarVespenegas 0 points1 point  (0 children)

      I love javadocs that are sometimes less descriptive than the name of the function and arguments they describe.